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com.geps.utii.ldap 

Class BaseDirectoryAdapter 

java.lang Object 

I - -cott.g*p» .utll . Idap .BaaeDir«ctoryAd*pter 



public abstract class BaseDirectoryAdapter 
extends java.lang.Object 
implements {BaseObjectClass 

Class Description: 

Base class for all Directory Adapters. This class is abstract and cannot 
be instantiated. 



Field Summary 1 


protected 

Directory Entry 


m_dir£ntry 


protected 
}ava.util .ArrayLiet 


mjnodi f ications 



Constructor Summary 

BaseDiraetoryAdaptcr ( ) 



Method Summary 


Director/Entry 


gttDirEatry { ) 

Desc: Use to get the Directory Entry from the adapter. 


java.util .ArrayLi»t 


geWtodif icationa ( ) 

Desc: Use to get the list of Modificationltem(s) applied to the adapter. 


protected void 


initialise (DirectoryEntry de > 
Desc: Used to initialize the adapter. 



Methods inherited from class Java.Iang.ObJect 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, toString, 
wait, wait, wait — — — — — 



[Field Detail 

m_dirEritry 

file://C:\Prc, cte\gc\framework\poc\src\com\gcps\unlMdap\c 
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protected Directory En try m_dirtBtry 



rage z oi 



m_modifications 

protected java.util.ArrayList «_modif icatioaa 

| Constructor Detail 

BaseDirectory Adapter 

public B*»«DirectoryAd»pter ( } 

[Method Detail ' 

initialize 

protected void iaitialiM (DirectoryEntry de) 

throws j avax . naming . NamingExcept ion 

Desc: Used to initialize the adapter. This is used by com.geps.unlldap.DirectoryManager when its getAdapterlnstance() 

method is called. 

Parameters: 

de - DirectoryEntry to initialize adapter with. 



getDirEntry 

public DirectoryEntry gatDirXntry { ) 

Desc: Use to get the DirectoryEntry from the adapter. 
Specified by: 

getDirEntry in interface IBaseObjectClass 

Returns: 

Returns the DirectoryEntry associated with the adapter. 



getModifications 

public java.util.ArrayList gatltodif icatioaa 0 

Desc: Use to get the list of Modificationltem(s) applied to the adapter. This method should not be used by clients. It is used 
by com.geps.utiLldap.DirectoryManager. 
Specified by: 

getModifications in interface IBaseObjectClass 
Returns: 

Returns the list of Modificationltem(s). 
Class Tree Deprecated Index Help 
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com.geps.uriUdap 

Class DirectoryEntry 

java . lang .Object 
I 

+ - - com. g«*p« . util . ldap . Directory totry 



public ciass DirectoryEntry 

extends java.lang.Object 

Clas* Description: 

Simple wrapper which represents a DirContext. 



Field Summary 


private }rva.l*ng. String 


m_dn 


private 

3 avax . aanxng . directory . Di rContext 


m_ent _ry 



Constructor Summary 



DirectoryHntry { j avax .naming . directory .DirContext entry) 
Desc: Constructor. 



Method Summary 


}avax . naming . directory . DirContext 


gatDirCtx ( } 

Desc: Use to retrieve the entry. 


3*v». l*ng .String 


toStr_ing ( ) 

Desc: Override toStringQ. 



Methods inherited from class JavaJsng.Object 



, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, wait, wait, 
wait ______ — — 



Field Detail 



m_dn 

private java. lang.s«--ing »_dn 



vork\poc\src\c- Ti\geps\util\ldap\com\geps^ 
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ui*^> uirecioryfcntry 

m_entry 

private j avax. naming. directory .DirContext »_«ntry 

Constructor Detail 

DirectoryEntry 

public Diractory«ntry( 3 avax. naming, directory. DirContext entry) 
Desc: Constructor. 

[Method DetaU 

getDirCtx 

public j avax. naming. directory. DirContext getDirCtxO 

Desc: Use to retrieve the entry. 
Returns: 

Returns the entry. 



toString 

public 3 ava.lang. String toString 0 

Desc: Override toStringO. 
Overrides: 

toString in class java.lang.Object 



Class Tree Deprecated Index Help 
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com.geps*utiUdap 

Class DirectoryManager 



j ava . 1 ang . Ob} ect 

I 

+ - - com . gepa . util . Idap . Dirac toryManager 



Class Iree Deprecated Index Help 
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public abstract class DirectoryManager 
extends j ava. lang. Obj ect 

Class Description: 

This class represents the Directory Framework in which clients will interface 
with to request Directory En try and object class adapters and to write 
entry modifications back to LDAP. 



a 



Field Summary 


private static java. lang. St ring 


s_adaptarPkg 


private 

static javax. naming. directory. InitialDirContext 


a_ctx 



Constructor Summary 

DirectoryManager ( ) 



Method Summary 


(package private) 
static void 


0 


private 

static j ava. lang. String 


•xtractLdapOb jClaaaHama { java . lang . String name) 

Desc: Helper which extracts the object class name from the specified 'name'. 


static BaseDirec;tojcy_A4*E£a£ 


9^tA^pte_rIri«tanc«(DirectoryEntry entry, java . lang . String adapterName) 
Desc: Use to obtain the specified 'adapterName' adapter from the specified 'entry'. 


static java.util.ArrayList 


aetAdapters (Directory En try entry) 

Desc: Use to obtain a list of all adapters that the specified 'entry is composed of. 


static DirectoryEntry 


StttetolHAMQfeLlfiSSClass adapter) 

Desc: Use to get Directory Entry from the specified 'adapter'. 


static DirectQryEnt£Y 


lookup < java. lang. String dn) 

Desc: Retrieves the DirectoryEntry whos key matches the the specified 'dn*. 


static j ava. util. Array Li st 


■earch(java. lang. String ctxToSearch, java. lang. St ring filter) 
Desc: Use to execvu a query against the Directory. 



file://C:\Projects\ge\fr ¥ >- - p\com\geps\uti/ idap\DirectoryManager.html 5 
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•tatie void 



writs (iBaseObleccClass adapter) 

Desc: Use to wnte out the contents specified by 'adapter* to LDAP. 



Methods inherited from c lass jivaJang.Object 

clone, equals, finalize, getClasa, haahCode, notify, notifyAll, registerNatives , tostrmg, 
wait, wait, wait 



Field Detail 

sjctx 

private static j avax, naming, directory. InitialDirContext »_ctx 



s_adapterPkg 

private static java.lang. String a_adaptarPxg 



Constructor Detail 



DirectoryManager 
public DiractoryKaaagarO 



Method Detail 



lookup 

public static Directory Entry lookup (3 ava . lang .String dn) 

throws j avax . naming . NamingException 

Desc; Retrieves the DirectoryEntry whos key matches the the specified 'dn'. 
Returns: 

DirectoryEntry associated with the specified , dn\ 
Throws: 

javax.naming.NamingException - If a naming exception occurs or if lookup did not return object of type 
DirContext 



getAdapterlnstance 

public static BaseDirectoryAdapter g«tAdmpt«rXnataac« (DirectoryEntry entry, 

java.lang. String adapterNarae) 
throws j avax . naming . NamingExcep tion , 

j ava . lang . ClassNotFoundExcept ion , 
j ava . lang . Ins tant iat ionExcept ion , 
java.lang. IllegalAccessException 

Desc: Use to obtain the specified 'adapterName' adapter from the specified 'entry*. If the requested 'adapterName 1 is not an 

object class of 'entry*, a null will be returned. 

Parameters: 

entry - DirectoryEntry in which to search 



file://C:\Projects\ge\frainework\poc\s^" 1 ^i^-hc^A^^v/ £ ? -n>i/r"3\idap\Director Manager.html 



12/13/9' 

6 



rage jui«» 



Returns: 

The adapter representing the object class specified by 'adapterName' from the DirectoryEntry 'entry' mill is 
returned if the specified 'adapterName' is not an object class of the specified 'entry'. 
Throws: 

javax.naming.NarningException - If a naming exceprion occurs. 



getEntry 

public static DirectoryEntry getEntry (IBaseObjectClass adapter) 

Desc: Use to get DirectoryEntry from the specified 'adapter*. 
Parameters: 

adapter - The adapter to get the DirectoryEntry from. 
Returns: 

The DirectoryEntry for the specified 'adapter 1 . 



write 

public static void writaUBaseOb^ectClaas adapter] 

throws javax . naming. NaraingExcept ion 

Desc: Use to write out the contents specified by 'adapter 1 to LDAP. 
Parameters: 

adapter - Object Class to wnte out. 



getAdapters 

public static j a va.util .Array List g*tAdapt«r» (DirectoryEntry entry) 

throws j avax . naming . NamingExcept i on 

Desc: Use to obtain a list of all adapters that the specified 'entry is composed of. Each adapter name returned can be 
passed into DirectoryManager.getAdapterInstance(DirectoryEntry, String) as the 2nd parameter to obtain an adapter 
instance. 
Parameters: 

entry - DirectoryEntry in which to discover all adapters for. 
Returns: 

■ on-null ArrayList of String adapters names. 



search 

public static java.util. ArrayList March (java.lang. string ctxToSearch, 

j ava . lang . String filter) 
throws 3 avax . naming .Naming Except ion 

Desc: Use to execute a query against the Directory. 
Parameters: 

ctxToSearch - Context to search. for current context, 
filter -LDAP filter. 
Returns: 

List of DirectoryEntries resulting from the query. Only DirContext objects are supported so if the query returns 
objects other than DirContext, they will not be in the List. 



fiie://C:\rYojects\ge\r>aniework\p^ »■ .;! iOv^v*- • • vManager.htm" 
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: Class DirectoryManager 
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eitractLdapObjClassName 

private static java. lang. String «trac tLdapObj CI as sN*m (java.iang. String name) 

Desc: Helper which extracts the object class name from the specified 'name', 'name 1 looks like 
"com.gepsJdap.PocuserAdapter". This method removes all package names the "Adapter" suffix is stripped and the 
remaining string returned. 
Parameters: 

name - Adapter names which are defined constants in DirectoryConstants or the object class name itself 
Returns: 

Returns ne LDAP object class name. 



static void (J 



Class Tree Deprecate d Index Help 
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PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER | FIELD | CQNSTR 1 METHOD DETAIL: FIELD j CONSTR \ METHOD 



com.geptutil.ldap 

Class Generator 

java.lang. Object 
I 

+--com.gap« .util.ldap.O«n«r*tor 



public abstract class Generator 
extends java.lang. Object 

Class Description: 

This class is used to generate java interfaces and adapters which represents 
LDAP ob}ect classes. For each LDAP object class there is one java interface 
and one }ava adapter. This class also generates the file DirectoryConstants 
which provides defined constants used to identify adapters. These classes \ 
are used in the java LDAP Directory frameworfc. This class is abstract so 
it cannot be instantiated. 



Inner Class Summary 


private 
static class 


Generator . HBP 

Desc: Helper class, Name Boolean Pair. i 



Field Summary 


private static 3 avm.lang. String 


s_cppyRightY«&r 


private static java. lang .String 


■_dataGanaratad 


private static java. laag. St ring 


»_p i r Cons tNaae 


private static java.lang. String 


■genSrcPath 


private 

a tat ic 3 avaa . naming . directory . InitialDirContext 


«_initDirCtx 


private static java. laag. String 


s_multiSuf£ix 


private 

static j avax . naming . directory . DirCentext 


chemaRoo t 


private static java. lang .String 


«_srcPathRoot 


private static java. lang. String 


s^ircPJcg 


private static java. lang .String 


s_ts 



file://C:\Projects\ge\framework\poc^ r -r! 
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Constructor Summary 



Generator ( ] 



Method Summary 



(package private) 
static void 



private static void 



addAttrNameToLiat (java. util .TreeSet store, 
3 avax . naming . NamingEnumeration vals ) 
Desc: Add attribute names to a TreeSet 



private static void 



emitAdaptart java. lang. St ring oc, }ava .util .TreeSet [} attrNames, 
java -.PrintStream out) 

_csc: Generates the adapter class for the specified object class. 



private static void 



emitAdapterCla«aBody (java. lang. String oc, java. util .TreeSet [] attrNames, 
j ava. io. PrintStream out) 

Desc: Writes the body of the adapter. 



private static void 



eaitAdapterOetterat java. util. TreeSet attrSet, java . 10. PrintStream out) 

Desc: For the specified 'attrSef will generate getters for ail attributes contained within for the 
adapter. 



pnvata static void 



emit -lapter Import a (java. io. PrintStream out) 
^esc: Writes the import statements for the Adapter. 



private static void 



•mitAdaptarNaaa (java. lang. String oc, java . io . PrintStream out) 
Desc: Writes the adapter name and opening curley. 



private static void 



ami tAdaptarSatteraC java. util. TreeSet attrSet, java . io. PrintStream out) 
Desc: Generate adapter setters for attributes. 



private static void 



•mitAdapterToString ( j ava . util . TreeSet (] attrNames , J ava . io . PrintStream 
Desc: Writes out the adapters toStringQ method. 



out) 



private static void 



«a4^daptarToSjtrJLngH«lper (java . 10 . PrintStream out ) 

Desc: Writes out the adapters toStringQ helper method 



private static void 



•jaitAllAdaptarQettera (java . util .TreeSet ( ] attrNames , 
java. io. PrintStream out) 

Desc: Writes out all adapter getters for both required and optional attributes. 



private static void 



•mitAllAdapterSattera (java. util .TreeSet [] attrNames, 
java.. 3, PrintStream out) 

Desc: Writes out all adapter setters for both required and optional attributes. 



private static void 



•mltAll^«x£as*fl«tt«« ( j ava . ut il . TreeSet [1 attrNames , 
java. io. PrintStream out) 

Desc: Writes out all interface getters for both required and optional attributes. 



private static void 



•aijLAllInterJLaceSettera (] ava. util .TreeSet [] attrNames, 
java. io. PrintStream out) 

Desc: Writes out all interface setters for both required and optional attributes. 



private static void 



•aitClosingClaaaBracJcet ( j ava . io . PrintStream out ) 
Desc: Writes the class closing curley. 



private static vcid 



amitCammentHaadar (java . io . PrintStream out) 
Desc: Writes the comment header for the file. 



private static void 



•mitpirConat (java. lang. String classNarae, java . io. PrintStream out) 
Desc: Write out adapter constant for the specified 'className'. 



private static void 



emitDirConatNaiae ( j ava . io . PrintStream out ) 
Desc: Writes the interface name and opening curley. 
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rage join 



private acatxe void 


ffla tyranJiodl f ladCacha ( i ava . io . Print Stream out) 1 
Dcsc: Writes out getFromModifiedCache method. 1 


private acacie void 


amitlntarfacaij ava. lang. String oc, java.util .TreeSet [] attrNames, J 
j ava. io.PrintSt ream out) 

Desc: Generates the interface class for the specified object class. 


private »L*tic void 


•mi tInterfac«Cla"«Body< java.util. TreeSet U attrNames, 1 
java.io. Print St ream out) 

Desc: Writes the body of the interface. 


private scacic void 


emitInt«r£ac«G«tt«r» ( ja-. -itil -TreeSet actrSet , j ava . io.PrxntSr ream out) 

Desc: For the specified 'attrSet' will generate getters for all attributes contained within for the 
interface. 1 


private atanc void 


emitlntorfaceliaF rts ( java. io. PrmtStream out) j 
Fi*c/*- Writhe tn.- ♦mnnrT ctatsTncnts for the Interface ! 


private static void 


amitlnterfaceNaaat j ava. lang. String oc, j ava . io . PrmtStream out) 1 
Desc: Wntes the interface name and opening curley. 


private atatic void 


emitlnterfacaSattarat java.util. TreeSet attrSet, java. io. PrmtStream out) j 

Desc: For the specified 'attrSet' will generate setters for all attributes contained within for the 
interface. 1 


private static void 


amitPackage ( java.io.PrintStream out) 1 
T^^ej** Writhe th# narWatM* statement. 1 


private atatic void 


gen«rata< java. lang. String U obj Classes) 1 
Desc: Directs the generation of interface and adapter classes. 1 


private atatic void 


g«tAttributai(java. lang. String oc, java.util .TreeSet mandatory, 1 
java.util .TreeSet optional) 1 
Recursively extracts all attributes for the specified 'oc* and all attributes of 'oc' superclasses. 


private 

•tatic lava .util .TreeSet 
11 


gatXttrLiat { j ava. lang. String oc) J 
Desc: Create a list of required and optional attribute names for the specified , oc' object class I 
and all attributes of 'oc* super object classes and so on by looking up these values in the LDAP 
Schema. J 


private 

static i ava. lang. String 

n 


gatObJClasaaa () 1 

Desc: This method will query LDAP to get all object class names and returns those names in an 

M«eaM« t At C4n«ft0 1 


private itatic void 


initialize 0 

rv«f n*t* rftfrtiired w^tem nrooerties. fieures out where to create the generated files. 


static void 


main (java. lang. String!] args) 
Desc: Program entry point. 


private static void 


•hutDqwn ( ) 

Desc: Release any remaing resources. 



Methods inherited from class javtulang.Object 

clone, equals, finalize, getClass, hashCode, notify. notifyAll, registerNatives, toString , 
wait, wait, wait -—«——— — — 



Field Detail 



s_multiSuffix 

private static final j ava. lang. String •_aultiSuf fix 
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Class uenenior -~ 
s_ts 

private static java. lang. String a_t» 

s^DirConstName 

private static final 3 ava . lang . String «_DirCon»tHa»« 

_ 0 

s_srcPathRoot 

private static java. lang. St ring «_«rcFathRoot 

s^genSrcPath 

private static java. lang. St ring •_g«nflrcPath 
s_srcPkg 

private static java. lang. String »_arcPJcg 

sJnitDirCtx 

private static j a vax. naming .directory . InitialDir Context «_iaitD±rCtx 

s_schemaRoot 

private static javax. naming. direct ory.DirContext •_sch«ma*oot 

s_dateGenerated 

private static java. lang. String ■_dat*Oan«rat«d 

s_copyRightYcar 

private static java. lang. String ^copyjtigat^ar 

1 Constructor Detail 

Generator 

public O*a«rator() 
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Method De lil 

main 

public static void aiin (java. lang . String [] args) 

Desc: Program entry point If an object class name does not exist an error message will be generated and processing 
continued. 



Parameters: 

args - Array of parameters. If the value of args[0].equals( M ALL tt ), then interfaces/adapters will be generated for all 
object classes in the LDAP. Any further arguments are ignored. But if the value of args[0] is not equal to "ALL", 
then the arguments are expected to be LDAP object class names. Each name passed in will be processed and a 
resulting interface/adapter will be generated. 



initialize 



private static void initialise 0 

throws j a va . lang . Except ion 



Desc: Gets required system properties, figures out where to create the generated files. 



generate 

private static void ganerata (java. lang. String U objClaseea) 

throws java. lang. Exception 

Desc: Directs the generation of interface and adapter classes. Interfaces are prefixed with an T and adapters arc suffixed 
with "Adapter". Also creates a file which contains constant strings used to identify object classes. 



emitlnterface 

private static void ami tlatarfaea (java. lang. St ring oc, 

java,util.TreeSet [] attrNames, 
java.io.PrintStream out) 
throws j avax . naming . NammgExcept ion 

Desc: Generates the interface class for the specified object class. 
Parameters: 

oc - Object Class to generate interface for. 

attrNames - Array of TreeSet object containing the required and optional attribute names. Required is at index 0, 
optional at index 1. 
out - Stream to write to. 



emitAdapter 

private static void ami tAdapter (java. lang. String oc, 

java.util.TreeSet 1} attrNames, 
java.io.PrintStream out) 
throws j avax . naming . NamingExcept ion 
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Desc: Generates the adapter class for the specified object class. 

Parameters: 

oc - Object Class to generate adapter for. 

attrNamea - Array of TreeSet object containing the required and optional attribute names. Required is at index 0. 
optional at index 1. 
out - Stream to write to. 



emitCommentHeader 

private static void «mitCanMntHaad«r ( j c a. 10. Print St ream out) 

Desc: Writes the comment header for the file. 
Parameters: 

out - Stream to write to. 



emitPackage 

private static void amitFackagaC java.io. Prints t ream out) 



Desc; Writes the package statement. 
Parameters: 

out - Stream to write to. 



emitlnterfacelmports 

private static void •mitlntarfiacalsiports (java.io . PrintSt ream out) 

Desc; Writes the import statements for the Interface. 
Parameters: 

out - Stream to write to. 



emitAdapterlmports 

private static void «ai tAdap tar Iapor ta (java. io. PrintSt ream out) 

Desc: Writes the import statements for the Adapter. 
Parameters: 

out - Stream to write to. 



emitlnterfaceName 

private static void «mi tin tarfacaKama (java. lang .String oc, 

java.io.PrintStream out) 

Desc: Writes the interface name and opening cuxicy. 
Parameters: 

oc - Object class name, 
rut - Stream to write to. 
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emitAdapterName 



private static void «»itAdaptarNa»a<j 

3 




Desc: Writes the adapter name and opening curley. 
Parameters: 

oc - Object class name. 

out - Stream to write to. 



emitDirConstName 

private static void •aitDirConatNaae (3 ava . io .Prints tream out} 

Dcsc: Writes the interface name and opening curley. 
Parameters: 

oc - "Object class name. 

out - Stream to write to. 



emitlnterfaceClassBody 

private static void mitliitarf ac«Claa«Body { java.util .TreeSet [] attrNames, 

j ava. io.PrmtSt ream out) 
throws 3 avax . naming . Naming Except ion 

Desc: Writes the body of the interface. 
Parameters: 



attrNames - An array of TreeSet objects containing the required and optional object class attribute names. 
TrceSet[0] - requried, TreeSct[l] - optional, 
out - Stream to write to. 



emitAdapterClassBody 

private static void amitAdaptarClaiaBody ( Java . lang. String oc, 

java. util. TreeSet [] attrNames, 
j ava. io. Print St ream out) 
throws j avax . naming . Naming Bxcep t ion 

Desc: Writes the body of the adapter. 
Parameters: 



oc * Object class name. 

att mamea - An array of TreeSet objects containing the required and optional object class attribute names. 
TreeSet[0] - requried, TreeSet[l] = optional, 
out • Stream to write to. 



emitAllInterfaceGetters 

private static void aaitAllIntarf acaQattara (java.util .TreeSet [] attrNames. 



java. io.PrintStream out) 



Desc: Writes out all interface getters for both required and optional attributes. 
Parameters: 

1 k& - . ui array of TreeSet containing the required and optional attribute names. 
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out - Stream to write to. 



emitAllInterfaceSetters 



private static void «»±tAllXnt«r£ac«B«tt«r. (java.u til .Tree Set [] attrNames, 

3 ava. io.PrintStream out) 

Desc: Writes out ail interface setters for both required and optional attributes. 
Parameters: 

attrNames - An array of TreeSet containing the required and optional attribute names, 
out - Stream to write to. 



emitAllAdapterGetters 

private static void •mitAlXAdapterQattara (java.util .TreeSet [] attrNames, 

java. io.PrintStream out) 

Desc: Writes out all adapter getters for both required and optional attributes. 
Parameters: 

attrNames - An array of TreeSet containing the required and optional attribute names, 
out - Stream to write to. 



emitAllAdapterSetters 

private static void «aitAliA<Upt«rS«tt«r» (java.util .TreeSet [] attrNames, 

java. io.PrintStream out) 

Desc: Writes out all adapter setters for both required and optional attributes. 
Parameters: 

attrNames - An array of TreeSet containing the required and optional attribute names, 
out - Stream to write to. 



emitlnterfaceGetters 

private static void •attlat#r««c«0«tt«ra (java. util. TreeSet attrSet, 

java. io.PrintStream out) 

Desc: For the specified 'attrSef will generate getters for all attributes contained within for the interface. 
Parameters: 

attrSet - Set of attribute names to generate getters for. 
out - Stream to write to. 



emitlnterfaceSetters 

private static void •mitlnt«rfac«8«tt«r« (java.util .TreeSet attrSet, 

java. io.PrintStream out) 

Desc: For the specified 'attrSet 1 will generate setters for all attributes contained within for the interface. 
Parameters: 

attrSet - Set of attribute names to generate setters for. 
out - Stream to write to. 
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emitAdapterSetters 

private static void «a±tAdapterS«tt«a ( java. util .TreeSet attrSet, 

java.io. Print Stream out) 

Desc: Generate adapter setters for attributes. 
Parameters: 

attrSet - Set of attribute names to generate setters for. 
out - Stream to write to. 



emitAdapterGetters 

private static void •m±tAdapt«rQ«tt«r» ( java .util .TreeSet attrSet, 

j ava . io . Prints tream out } 

Desc: For the specified 'attrSet' will generate getters for all attributes contained within for the adapter. 
Parameters: 

attrSet * Set of attribute names to generate getters for. 
out - Stream to write to. 



emitGetFromModifiedCache 

private static void «mitO«tFroaModif iedCacbe (java.io. Prints tream out) 

Desc: Writes out getFromModifiedCache method. This is a getter helper method which looks into the modified cache for 

changes. 

Parameters: 

out - Stream to write to. 



emitAdapterToString 

private static void «*itJUUpt«rToStri»g (java. util .TreeSet [] attrNames, 

java.io. Print St ream out) 

Desc: Writes out the adapters toStringO method. 
Parameters: 

attrNames - An array of TreeSet containing the required and optional attribute names, 
out - Stream to write to. 



emitAdapterToStringHelper 

private static void •mitAd*pt«rToStringH«lp«r ( java. io . Prints tream out) 

Desc: Writes out the adapters toStringO helper method. 
Parameters: 

out - Stream to write to. 



emitDirConst 
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private static void «»±tDirCon«t { java.lang. String className, 

java.io. Prints tream out) 



Desc: Write out adapter constant for the specified 'className'. 
Parameters: 

className - Object class name to write constant for. 
out - Stream to write to. 



emitClosingClassBracket 

private static void •mitCloaingClasaBraekat { java. lo.PrintStream out) 

Desc: Writes the class closing curiey. 
Parameters: 

out - Stream to write to, 



shutDown 

private static void ahutDownO 

throws j avax . naming .NamingException 

Desc: Release any remaing resources. 



getObjClasses 

private static java.lang. String [) gatObjClaasas < ) 

throws j avax . naming . NamingExcept ion 

Desc: This method will query LDAP to get all object class names and returns those names in an array of Strings. 
Returns: 

Returns an array of Strings containing all object class names. 
Throws: 

javax.naming.NamingException - If a naming exception occurs. 



getAttrList 

private static java.util .TreeSet [1 gatXttrLiat ( java. lang. St ring oc) 

throws j avax . naming . NamingExcept ion 

Desc Create a list of required and optional attribute names for the specified *oc' object class and all attributes of 'oc' super 
object classes and so on by looking up these values in the LDAP Schema. Along with each attribute name is a boolean flag 
which indicates if the attribute is single valued or not. Returns this information in an array of TrecSet objects. The first 
element in the array contains the required attributes and the second element contains the optional attributes. The elements 
in contained in the TreeSet are Generator.NBP objects (Name Boolean Pair). The name is the attribute name and the 
boolean indicates if it is single valued or not 
Parameters: 

oc - Object class name to build attribute list for. 
Returns: 

Array of TreeSet containing the required and optional attributes. 



getAttributes 
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private static void g«tAttribut«s ( java.lang* String oc, 

j a va,util, TreeSet mandatory, 
java.util. TreeSet optional) 
throws j avax . naming . NamingExcept ion 

Recursively extracts all attributes for the specified 'oc' and all attributes of 'oc 1 superclasses. 
Parameters: 

oc - Object class name in which to extract attributes for. 
mandatory - TreeSet to store mandatory attributes, 
optional - TreeSet to store optional attributes. 



addAttrNameToList 

private static void addAttrNaaaTo&ist (java.util .TreeSet store, 

j avax. naming. NammgEnuTiter at ion vals) 
throws j avax. naming . NamingExcept ion 

Desc: Add attribute names to a TreeSet. TreeSet does not allow dups. For each attribute Vals', this method also determines 
if that attribute is single or multivalued. The attribute name and whether it is single valued or not is added to 'store* as 
Generator.NBP (Name Boolean Pair) object. 
Parameters: 

store - TreeSet to store attribute names 

vals - Enumeration of attribute names 



static void 0 
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Class Tree Deprecated I ndex Help 

PREV CLASS NEXT CLASS 

SUMMARY: INNER j FfgUP | CONSTR j MgTHOp 

cotn.geps.iitlUdap 

Class Generator.NBP 

j ava. lang. Object 

i 

+ t - com . g«p» . util . ldap . Gtttrator . HBP 

Enclosing class: 

Generator 



private static class Generator.NBP 
extends java.lang.Object 
implements java.lang.Comparable 

Desc: Helper class. Name Boolean Pair. Holds attributeName t isSingle boolean pair. 



Field Summary 


j ava . lang . S t ring 


m_attrN«M 


boolean 


m_iaSingl« 



Constructor Summary 

Generator. HBP(java. lang. String attrNarae, boolean isSingle) 



Method Summary 


int 


ccmparaTo ( j ava . lang . Ob j ect ob j ) 



Methods inherited from clan jiva.iang.Object 

, clone, equals, finalize, getClass, haahCode, notify, notifyAll, regis terNativea, toString, 
wait, wait, wait 



Field Detail 



m_attrName 

public j ava. lang. String »_attrNaaa 



FRAMES NO FRAMES 

DETAIL FIELD I CONSTR t METHOD 
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mJsSingle 

public boolean a_±aSingle 



Constructor Detail 



Generator.NBP 

public Generator. HBPtjava. lang. String attrName, 
boolean isSingle) 



Method Detail 



corapareTo 

publ i c int corapareTo { j ava . lang . Ob j ect ob j ) 

Specified by: 

compartTo in interface Java. lang. Comparable 



Ctass Tree Deprec ated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD \ CONSTR | METHOD 
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Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS 

SUMMARY: INNER I FIELD 1 CONSTR 1 METHOD 

com.gcp4.util.ld1p 

Interface IBaseObjectCIass 

All Known Implementing Classes: 

BaseDirectory Adapter 

public interface IBaseObjectCIass 

Class Description: 

Base interface for all object class interfaces* 



Method Summary 


SirectoryXntry 


g«t_D_ir*atry{) 


j *va . u 1 1 1 . Array Liat 


g«tModi£± cation* ( } 



Method Detail 

getModifications 

public java.util.ArrayList gatltodlf ieationa (} 



getDirEntry 

public Directory Entry g«tCirXntry (} 



Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER { FIELD (.CONSTR | MgtHOD DETAIL: FIELD | CONSTR | METHOQ 



FRAMES NO FRAMES 

DETAIL: FIELD | CONSTR | METHOD 
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Class Tree Deprecated Index Help 

P*EV CLASS NEXT CLASS 
SUMMARY: INNER | FIELD | CONSTR | METHOD 



com.gtps.utiUdap 

Class Util 

j ava . lang . Ob j ect 

! 

- - - cott* gmpm . util . ldap . Util 



public abstract class Util 
extends java.lang.Object 

Class Description: 

Utility methods used by classes in the com, geps .util . Idap package. This 
class is abstract and cannot be instantiated. 



Field Summar 


y 


static 3 ava. lang. St ring 




static 3 ava. lang. String 


INT KRF AC S_ PREFIX 



Constructor Summary 

DtiK) 



Method Summary 


static 3 ava. lang. string 


convrtToValidXajthodMamti { j ava . lang . String s t r 

Dcsc: Will return a string with the same contents of 'sir out with the 1st character uppercased, 
the rest of the characters lower case and any to ' J. 



Methods Inherited from class JavaJang.Object 

, clone, equals, finalize, getClasa, hashCode, notify, notifyAll, regis terNatives, toString, 
wait, wait, wait 



Field Detail 



INTERFACEJPREFIX 

public static final j ava. lang. St ring INTIRTACX PRX7IX 



FR AMES NO FRAMES 

DETAIL* FIELD | CONSTR | METHOD 
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Overview Pa ckage Class Use Tree Deprecated Index He|p 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL FIELD | CONSTR | METHOD 



java.Iang. reflect 

Class Proxy 

1 ava . lanq . Obi ect 

java. lang. reflect . Proxy 

All Implemented Interfaces: 

Serializable 



public class Proxy 
^ extends Object 

implements Serializable 

iri Proxy provides static methods for creating dynamic proxy classes and instances, and it is also the superclass of all 
|j1 dynamic proxy classes created by those methods 

%Q To create a proxy for some interface Foo 

s InvocationHandler hancL -r = new MylnvccationHandler ( . . . ) ; 

f 55 ? Class proxyClass = Proxy . getProxyCIass ( 

fj Foo . class . getClassLoader () , new Class [] { Foo.cl.ss }); 

La Foe f = i Foo) proxyClass. 

y getConstructor ( new Class [] { InvocationHandler . class }). 

:X : newlnstance [new Ob]ect[] { handler )); 

M 

or more simply 

Foo f = 'Foo j Prdxy . newProxylns tance (Foo . class . getClassLoader O , 

new Class[] { Foo. class ), 
handler} ; 



A dynamic proxy class (simply referred to as a proxy class below) is a class that implements a list of interfaces 
specified at runtime when the class is created, with behavior as described below. A proxy interface is such an 
interface that is implemented by a proxy class. A proxy instance is an instance of a proxy class. Each proxy instance 
has an associated invocation handler object, which implements the interface Inv ocationHandler . A method 
invocation on a proxy instance through one of its proxy interfaces will be disp ned to the invoke method of the 
instance's invocation handler, passing the proxy instance, a j ava . lang . ref le Method object identifying the 
method that was invoked, and an array of type ob]ect containing the arguments. The invocation handler processes 
the encoded method invocation as appropriate and the result that it returns will be returned as the result of the 
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method invocation on the proxy instance. 
A proxy class has the following properties. 

• Proxy classes are public, final, and not abstract 

• The unqualified name of a proxy class is unspecified The space of class names that begin with the string 
"$ Proxy" should be, however, reserved for proxy classes 

• A proxy class extends nava.lang. reflect. Proxy. 

• A proxy class implements exactly the interfaces specified at its creation, in the same order 

• If a proxy class implements a non-public interface, then it will be defined in the same package as that interface 
Otherwise, the package of a proxy class is also unspecified. Note that package sealing will not prevent a pro\\ 
class from being successfully defined in a particular package at runtime, and neither will classes already defined 
in the same class loader and the same package with particular signers. 

• Since a proxy class implements all of the interfaces specified at its creation, invoking getinterf a:es on its 
class object will return an array containing the same list of interfaces (in the order specified at its creation), 
invoking getMethods on its class object will return an array of Method objects that include all of the methods 
in those interfaces, and invoking getMethod will find methods in the proxy interfaces as would be expected 

• The Proxy. isProxvclass method will return true if it is passed a proxy class- a class returned by 

fssj Proxy .getProxyciass or the class of an object returned by Proxy . newProxyinstar.ee- and false otherwise 

Jt • The java. security . ProtectionDomair: of a proxy class is the same as that of system classes loaded by the 

Cj bootstrap class loader, such as java . lang . object, because the code for a proxy class is generated by trusted 

IJl system code This protection domain will typically be granted java.security.AUPermission 

IJl • Each proxy class has one public constructor that takes one argument, an implementation of the interface 

111 i nvocationHandier , to set the invocation handler for a proxy instance. Rather than having to use the 

J3 reflection API to access the public constructor, a proxy instance can be also be created by calling the 

Si Proxy. newinstance method, which combines the actions of cal 1 ;g Proxy, get Proxyciass with invoking the 

^ constructor with an invocation handler 

*j\ proxy instance has the following properties 

^ • Given a proxy instance proxy and one of the interfaces implemented by its proxy class Foe, the following 
fT expression will return true. 

proxy instanceof Foo 

and the following cast operation will succeed (rather than throwing a ciassCastException) 

(Foo) proxy 



• Each proxy instance has an associated invocation handler, the one that was passea co its constructor The static 
Proxy. qetinvocationHandier method will return the invocation handler associated with the proxy instance 
passed as its argument. 

• An interface method invocation on a proxy instance will be encoded and dispatched to the invocation handler's 
invoke method as described in the documentation for that method. 

• An invocation of the hashcode, equals, or tost ring methods declared in java.iang. object on a proxy 
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instance will be encoded and dispatched to the invocation handler's invoke method in the same manner as 
interface method invocations are encoded and dispatched, as described above. The declaring class of the 
Method object passed to invoke will be java. iang.obiect Other public methods of a proxy instance 
inherited from iava . lang. object are not overridden by a proxy class, so invocations of those methods 
behave like they do for instances of ] ava . lang . ob] ect. 

Methods Duplicated in Multiple Proxy Interfaces 

When two or more interfaces of a proxy class contain a method with the same name and parameter signature, the 
order of the proxy class's interfaces becomes significant When such a duplicate method is invoked on a proxv 
instance, the Method object passed to the invocation handler will not necessarily be the one whose declaring class is 
assignable from the reference type of the interface that the proxy's method was invoked through This limitation exists 
because the corresponding method implementation in the generated proxy class cannot determine which interface it 
was invoked through Therefore, when a duplicate method is invoked on a proxy instance, the Method object for the 
method in the foremost interface that contains the method (either directly or inherited through a superinterface) in the 
proxy class's list of interfaces is passed to the invocation handler's invoke method, regardless of the reference type 
through which the method invocation occurred 

| If a proxy interface contains a method with the same name and parameter signature as the hashcode, equals, or 
1 tostring methods of java. lang .object, when such a method is invoked on a proxy instance, the Method object 
| passed to the invocation handler will have ] ava . lang . ob j ect as its declaring class. In other words, the public, non- 
1 final methods of java . lang . object logically precede all of the proxy interfaces for the determination of which 
1 Method object to pass to the invocation handler 

\ Note also that when a duplicate method is dispatched to an invocation handler, the invoke method may only throw 
4 checked exception types that are assignable to one of the exception types in the throws clause of the method in all of 
j the proxy interfaces that it can be invoked through If the invoke method throws a checked exception that is not 
[ assignable to any of the exception types declared by the method in one of the the proxy interfaces that it can be 
, invoked through, then an unchecked UndeciaredThrowableExceptxon will be thrown by the invocation on the 
I proxy instance This restriction means that not all of the exception types returned by invoking getExceptionTypes 
* on the Method object passed to the invoke method can necessarily be thrown successfully by the invoke method 

Since: 

JDK1.3 
See Also: 

invocationHandier , Serialized Form 



Field Summary 

:rv .. :a: j;;: e ;;!r 

the invocation handler for this proxy instance 
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Constructor Summary 



Proxy : InvocationHandler h) 

Constructs a new Proxy instance from a subclass (typically, a dynamic proxy class) with the 
specified value for its invocation handler 



Method Summary 



getlnvocationHandler f Obi ect proxy) 

Returns the invocation handler for the specified proxy instance 



getProx yClass ( Clas sLoader loader, Class [ ] interfaces; 

Returns the j ava . lang . class object for a proxy class given a class loader and an 
array of interfaces 



isProxyClass ( Class cl) 

Returns true if and only if the specified class was dynamically generated to be a 
proxy class using the getProxyclass method or the newProxyinstance method 



newProxy Instance ( Class Loader loader, Class [ ] interfaces, 
InvocationHandler h ) 

Returns an instance of a proxy class for the specified interfaces that dispatches 
method invocations to the specified invocation handler. 



Methods inherited from class java.lang. Object 



clone , equals , finalize , lass , hashCode , notify , notif yAll , toStrmq , wait, wait , wait 



Field Detail 



protected InvocationHandler h 



the invocation handler for this proxy instance 



Constructor Detail 



Proxy 



protected Proxy ( InvocationHandler h) 



Constructs a new Proxy instance from a subclass (typically, a dynamic proxy class) with the specified value for 

its invocation handler 

Parameters: 
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h - the invocation handler for this proxy instance 



Method Detail 



getProxyClass 

publ_ . static C lass getProxyClass ClassLoader loader, 

Class [ ] interfaces; 
thro w s I Ile a a 1 A r q ume ntExceptio r. 

Returns the 3 a va. lang. class object for a proxy class given a class loader and an array of interfaces The 
proxy class will be defined in the specified class loader and will implement all of the supplied interfaces If a 
proxy class for the same permutation of interfaces has already been defined in the class loader, then the existing 
proxy class will be returned, otherwise, a proxy class for those interfaces will be generated dynamically and 
defined in the class loader 

There are several restrictions on the parameters that may be passed to Proxy. get Proxyciass. 

• All of the class objects in the interfaces array must represent interfaces, not classes or primitive 
types 

• No two elements in the interfaces array may refer to identical class objects 

• All of the interface types must be visible by name through the specified class loader In other words, for 
class loader cl and every interface 1, the following expression must be true 

Class . f orName f i . getName ( 1 , false, cl; ==1 



• All non-public interfaces must be in the same package; otherwise, it would not be possible for the proxy 
class to implement all of the interfaces, regardless of what package it is defined in 

• No two interfaces may each have a method with the same name and parameter signature but different 
return type 

• The resulting proxy class must not exceed any limits imposed on classes by the virtual machine For 
example, the VM may limit the number of interfaces that a class may implement to 65535; in that case, 
the size of the interfaces array must not exceed 65535 

If any of these restrictions are violated, Proxy .get ProxyClass will throw an IllegalArgumentException. If 

the interfaces array argument or any of its elements are null, a NullPointerException will be thrown 

Note that the order of the specified proxy interfaces is significant, two requests for a proxy class with the same 
combination of interfaces but in a different order will result in two distinct proxy classes. 

Parameters: 

loader - the class loader to define the proxy class in 
interfaces - the list of interfaces for the proxy class to implement 
Returns: 

a proxy class that is defined in the specified class loader and that implements the specified interfaces 
Throws: 



5 



Page 5 of 



Java 2 Platform SE v 1 .3 : Class Proxy 



httpi/^ava.sunxon^ 



iilegaiArqumentException - if any of the restrictions on the parameters that may be passed to 
getProxyciass are violated 

Nun Pc :n z e r Exception - if the interfaces array argument or any of its elements are r.-ii 



newProxylnstance 

public static Obi ec t newProxylnstance \ Class Loader loader, 

C lass [ ] interfaces, 
InvocationHandler h) 
throws IilegaiArqumentException 

Returns an instance of a proxy class for the specified interfaces that dispatches method invocations to the 
specified invocation handler. This method is equivalent to. 

Proxy , get ProxyCiass (loader , interfaces) . 

get Constructor (new Class T { InvocationHandler . class }). 
newlnstance { new Object [] < handler ]}; 

!? 

S Proxy . newProxylnstance throws IllegalArgumentException for the same reasons that 

j Proxy. getProxyClass does 

0 

fl Parameters: 

n loader - the class loader to define the proxy class in 

3 interfaces - the list of interfaces for the proxy class to implement 

'4 h - the invocation handler to dispatch method invocations to 

Returns: 

J a proxy instance with the specified invocation handler of a proxy class that is defined in the specified 

Z class loader and that implements the specified interfaces 

f. Throws: 

Z IilegaiArqumentException - if any of the restrictions on the parameters that may be passed to 

7 getProxyciass are violated 

N uiiPointerException - if the interfaces array argument or any of its elements are null, or if the 

invocation handler, h, is null 



isProxyCIass 

public static boolean isProxyCIass ( Class cl) 

Returns true if and only if the specified class was dynamically generated to be a proxy clas ising the 

getProxyClass method Or the newProxylnstance method. 

The reliability of this method is important for the ability to use it to make security decisions, so its 
implementation should not just test if the class in question extends Proxy 
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Parameters: 

el - the class to test 
Returns: 

true if the class is a proxy class and false otherwise 
Throws: 

Null Pointer Except! on - if cl is null 



getlnvocationHandler 

public static InvocationHandler getlnvocationHandler (Object proxy) 

thro: - IlleqalArqumentExr e 

Returns the invocation handler for the specified proxy instance. 
Parameters: 

proxy - the proxy instance to return the invocation handler for 
Returns: 

q the invocation handler for the proxy instance 

yrj Throws: 

SJ il legaiArcrument Except ion - if the argument is not a proxy instance 

III Overview Package Class Use Tree De precated I ndex Help 

yfl PRE V CLASS NEXT CLASS FRAM ES NO FRA MES 

CjSUMMARY: INNER i FIELD I CONSTR . METHOD DE Ti '!_ FIELD i CONSTR 1 METHOD 

* Submit a bug or feature 

pFor further API reference and developer documentation, see Java 2 SDK SE Developer Documentatio n That documentation contains 
i^more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code 
.^examples. 

;i4java. Java 2D. and JDBC are trademarks or registered trademarks of Sun Microsvstems. Inc m the US and other countries. 
^Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road 
r >aio Alto. California. 94303, U.S.A. All Rights Reserved 



Java™ 2 Platform 
SuL Ed vU 
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javaJang. reflect 

Interface InvocationHandler 



public interface InvocationHandler 

InvocationHandler is the interface implemented by the invocation handler of a proxy instance 

Each proxy instance has an associated invocation handler When a method is invoked on a proxv instance, the method 
invocation is encoded and dispatched to the invoke method of its invocation handler 

Since: 

O JDK1.3 

^See Also: 

~~4 Proxy 



Method Summary 



invoke ( Obiect proxy, Method method, Obiect [ 1 args) 



Processes a method invocation on a proxy instance and returns the result 



Method Detail 

invoke 



public O biect invoke ( Object proxy, 

Method method, 
Obiect [ 1 args) 
throws Throwable 



Processes a method invocation on a proxy instance and returns the result. This method will be invoked on an 

invocation handler when a method is invoked on a proxy instance that it is associated with. 

Parameters: 

proxy - the proxy instance that the method was invoked on 

method - the Method instance corresponding to the interface method invoked on the proxy instance The 
declaring class of the Method object will be the interface that the method was declared in, which may be 
a superinterface of the proxy interface that the proxy class inherits the method through 
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args - an array of objects containing the values of the arguments passed in the method invocation on the 
proxy instance, or null if interface method takes no arguments Arguments of primitive tvpes are 
wrapped in instances of the appropriate primitive wrapper class, such as j ava . lang . integer or 

j ava . lang . Boolean 

Returns: 

the value to return from the method invocation on the proxy instance If the declared return type of the 
interface method is a primitive type, then the value returned by this method must be an instance of the 
corresponding primitive wrapper class, otherwise, it must be a type assignable to the declared return 
type If the value returned by this method is null and the interface method's return type is primitive, then 
a NullPcmterException will be thrown by the method invocation on the proxy instance If the value 
returned by this method is otherwise not compatible with the interface method's declared return type as 
described above, a ciasscastException will be thrown by the method invocation on the prow- 
instance 
Throws: 

Th rowabie - the exception to throw from the method invocation on the proxy instance The exceptions 
type must be assignable either to any of the exception types declared in the throws clause of the 
interface method or to the unchecked exception types 3 ava . lang. RuntimeException or 

ava . lang . Error. If a checked exception is thrown by this method that is not assignable to any of the 
exception types declared in the throws clause of the interface method, then an 
ungeciaredThrowabieExceotion containing the exception that was thrown bv this method will be 
thrown by the method invocation on the proxy instance 
See Also: 

UndeclaredThrowableExceptron 



Overview Package Class Use Iree Deprecated Index Help Java™ 2 Platform 

^REV CLASS NEXT CLASS FRAMES NO FRAMES Std Ed. vl 3 

J3UMMARY: INNER 1 FIELD ! CONSTR j MEIHOD DETAIL FIEL^TcQNSTR j METHOD 

Slibmit a bug or feature ~ " ' - - - 

m further API reference and developer documentation, see Java 2 SDK SE Developer Docnn^msnnn That documentation contains 
fgre deta;,d. daclopcr-targetcd descriptions, with conceptuln^^ 

gva. Java 2D and JDBC are trademarks or registered trademarks of Sun Microsystems. Inc in the US and other countries 
Copyright 1993-2000 Sun Microsystems. Inc 901 San Antonio Road * countries. 

Paio Alto. California. 94303. U S. A Ail Rights Reserved, 
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Package com.gepower.sfo.tool.Idap 



Interface Summary 


DirectonManager 


DirectoryManager provides an interface for accessing Director}* data 


DirectorvSou rce 


DirectorySource is an interface which provides access to Directory data sources 





Class Summary 




DefaultDirectorvSource 


DirectorySource implementation 




DirectorvEntrv 


Represents an LDAP Directory Entry and a LDAP invocation handler used in Proxy 
instances 




DirectorvManagerFactorv 


Use to create an object which implements the DirectoryManager interface 


Ls : 


Generator 


Generates Java interfaces which represents LDAP object classes. 
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Package com.gepower.sfo.tool.ldap 



Interface Summary 


DirectorvManager 


DirectorvManager provides an interface for accessing Directory data 


DirectorySource 


DirectorvSource is an interface which provides access to Directory- data sources 



Class Summary 


DefaultDirectorvSource 


DirectorySource implementation. 


DirectorvEntrv 


Represents an LDAP Directory Entry and a LDAP invocation handler used in Proxv 
instances. 


! DirectorvManagerFactorv 


Use to create an object which implements the DirectoryManager interface 


^Generator 


Generates Java interfaces which represents LDAP object classes. 



J Overview Package Class Tree Deprecated Index Help 

PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES 



2 

Page 1 of 



\Geps(24376)\8007(LDAP)\US01\Documentation\sfo-tool\sfo-tool\com\gepowe^ 



Overview Package Class Tree Depr ecated Index Hejp 

„„.,..... ,« F RAMES NO FRAMES 
^^uSSStFcOHST* , m Bj^TRELD.CONSTR, METHOD 



com.gep<mer.sfo.tooi.ldap 

Interface DirectoryManager 



public interface DirectoryManager 

Dire >ryManager provides an interface for accessing Directory data 



Method Summary 




cast : lava . lanq .Obiect entry, ] ava . lang . Class inter f aceToCastTc } 

This method provides backward compatibility from Java 1 3 to Java 1 2 which does not 
support the Proxy class. 




cjetDN ; lava . lanq . Obi ect entry) 

Use to get the specified entry distinquished name 




lookup (i ava. lanq. St ring dn) 

Use to lookup a specific entry identified by the specified 'dn' 




mixmlnterfaces dava . lanq. Obi ect entry, j ava . lang. Class [ ] newlnter faces . 

Use to add additional interfaces specified by 'newlnterfaces' to an existing 'entry' 




newEntrylnstance ( i ava . lanq . String dn, i ava . lang. Class [ 3 interfaces } 
Use to create a new LDAP entry 




remove n ava . lanq . Ob i ect entry] 

Use to remove an existing entry from the Directory 




search n ava. lanq. St ring ct:-: T oSearch, i ava . 1.- .g . String filter) 

Use to execute a query against the Directory using the specified 'ctxTo Search', and 'filter' 




search (i ava. lanq. String ctxToSearch, j ava . lang . 3 tring filter, 
1 avax . naming . directory. SearchControls searchCtrls } 

Use to execute a query against the Directory using the specified 'ctxToSearch', 'filter', and 
'searchCtrls. 




search ( i ava . lanq . String ctxToSearch, 1 ava . lang . St ring filter, 

i - -ax. naming. directory. SearchControls searchCtrls, i avax . naming . Idap. Control 

L reqCtrls} 

Use to execute a query against the Directory using the specified 'ctxToSearch', 'filter*, 
'searchCtrls, and 'reqCtrls' 
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" 2 write (]ava. lang. Object entry) 

Use to commit a new entry or modifications of an existing entry to the Directory 



Method Detail 



newEntrylnstance 

publi.- -ava. lang. Object newEntrylnstance : ava . lang . St ring dn, 

i ava . lang . Class [ ] interfaces 
tnrows j avax . naming . NamingException 



Use to create a new LDAP entry The entry is not written to the Directory until DirectoryManager writeQ is 

executed. 

Parameters: 

dn - Distinquished name for the new entry Must not be null or empty 

interfaces - Array of Class objects which represent the interfaces that this new entry will support The 
Class objects MUST be one of the LDAP code generated interfaces Array must not be null or empty 
Returns: 

Object representing the directory' entry This object can be cast to the appropriate "objectclass" interface 
(s) 

Throws: 

-avax. naming. NammgExcepti ?n - if a naming excepuon is encountered 



O mixinlnterfaces 

Q .blic java . lang. Obi ect mixinlnterfaces [j ava . lang . Ob] ect entry, 
fll java . lang . Class [ ] newlnter faces ) 

throws i avax . naming . NamingException 

Use to add additional interfaces specified by 'newlnterfaces' to an existing 'entry'. The modified entry is not 

written to the Directory until DirectoryManager. write() is executed. 

Parameters: 

entry - Existing LDAP entry to mix new interfaces into 'entry' must be acquired by calls to 
DirectoryController lookupO, DirectoryController search(), or DirectoryController newEntrylnstanceQ 
newlnterfaces - Array of new interfaces to mix into the entry. Must not be null and must not be empty 
Returns: 

Object representing the modified directory entry This object can be cast to the appropriate "objectclass" 
interface(s) including those contained in 'newlnterfaces'. 
Throws: 

j avax . naming . NamingException - if a naming exception is encountered 



lookup 
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public nava. iang. Object lookup I Java . iang . String dn) 

throws ]avax. naming. NameNotFoundException, 
3 avax. naming . NamingException, 
j ava , iang . ClassNotFoundException 



Use to lookup a specific entry identified by the specified 'dn' 
Parameters: 

dn - The distinquished name which uniquely identifies the entry Must not be null and must not be empt\ 
Returns: 

Object representing the dilatory entry'* bound to the specified dn This object can be ca? r to the 
appropriate "objectclass" interface(s) 
Throws: 

j b ax. naming. wameNotFcundExcepncr. - if dn cannot be resolved because it is not bound 
j avax* naming. NamingExcepricn - if a naming exception is encountered 

-ava. iang. ciassNotFoundExcepnon - if the looked up entry contains an object class which does ...>t 
have an associated code generated interface 



[search 



jjipubiic java.uril.Lisr search f j ava . Iang . String ctxTcSearch, 

f» j ava . iang . String filter- 

Ji; throws javax . naming. NamingException, 

] ava . iang . ClassNotFoundException 



Use to execute a query against the Directory using the specified 'ctxToSearch', and 'filter' 
Parameters: 

ztxTc search - Context to search M " for current context Must not be null 
filter - LDAP search filter Must not be null 
Returns: 

List of Objects representing the results of the sea: ± These Object can each be cast to the appropriate 
"objectclass" interface(s). If search finds nothing, List returned will have size of zero Return will never 
be null 
Throws: 

i ava . iang . ClassNotFoundException - if the entries found contains an object class which does not 
have an associated code generated interface 

3 a vax. naming. NamingException - if naming exception is encountered. 



search 



public j ava . utii . List search ( ]ava . iang . String ctxTcSearch, 

j a va . lang. String filter, 

javax . naming . directory . Sear chControls searchCtrls } 
throws i a vax . naming . NamingException, 

j ava . iang . ClassNot FoundExceotion 
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Use to execute a query against the Directory using the specified 'ctxToSearch', 'filter', and 'searchCtrls 
Parameters: 

ctxiosearch - Context to search for current context. Must not be null 
filter - LDAP search filter Must not be null 

searchctris - Used to determine scope of search and what gets returned Ma> be null If null, defaults 
will be used (search using SearchControls SUBTREE_SCOPE) 
Returns: 

. List of Objects representing the results of the search These Object can each be cast to the appropriate 
"objectclass" interface(s) If search finds nothing, List returned will have size of zero Return will nev er 
be null 
Throws: 

java.iang.ciassMctFoundExceprion - if the entries found contains an object class which does not 
have an associated code generated interface 

javax. nammq. Naming Except ion - if naming exception is encountered. 
See Also: 

SearchControls 



J search 

jpublic ]ava. util . List search { ] ava . lang . St ring ctxToSearch, 

Java. lang. String filter, 

j avax . naming . directory . SearchControls searchCtrls, 
j avax . naming . Idap . Control [ j reqCtrls ) 
throws javax . naming . NammgException, 

J ava . lang . Clas sNotFoundException 

Use to ^ecute a query against the Directory using the specified 'ctxToSearch', 'filter' 'searchCtrls and 
'reqCtrls' 
Parameters: 

ctxToSearch - Context to search "" for current context Must not be null, 
filter - LDAP search filter. Must not be null 

searchctris - Used to determine scope of search and what gets returned May be null If null, defaults 
will be used (search using SearchControls. SUBTREESCOPE). 

reqCtrls - A control to request the LDAP search to return in a certain way (i e, son results in a 
particular way) May be null. If null no LDAP request controls will be used 
Returns: 

List of Objects representing the results of the search These Object can each be cast to the appropriate 
n objectclass M interface(s). If search finds nothing, List returned will have size of zero. Return will never 
be null 
Throws: 

java . lang. ciassNotFoundException - if the entries found contains an object class which does not 
have an associated code generated interface. 

j avax . naming . NammgException - if naming exception is encountered 
See Also: 

SearchControls, Control 
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write 

cubiic void write ::ava.lang. Object entry) 

throws j avax . naming . NammgException 

Use to commit a new entry or modifications of an existing entry to the Directory 
Parameters: 

entr- Entry to commit to the directory 'entry' must have been acquired by calls to 
DirectoryController lookupO, DirectoryController search(), or DirectoryController nev\Entr\lnstance( ) 
Must not be null 
Throws: 

-avax. naming. NammgException - if naming exception is encountered. 



remove 

tfpublic void remove ( j ava . lang . Object entry) 

*Q tnrows j avax . naming . NammgException 

Ul Use to remove an existing entry from the Directory, 

jj Parameters: 

4j entry - Entry to remove from the directory, 'entry' must have been acquired by calls to 

!fi DirectoryController lookupO, DirectoryController search(), or DirectoryController newEntryInstance{ ) 

~" Must not be null 

Throws: 

2 i avax. naming. NammgException - if naming exception is encountered 



public java. lang. Object cast ( j ava . lang . 0b j ect entry, 

java. lang. Class inter faceToCastTo ) 
throws ] ava . lang . Class Cas tException 

This method provides backward compatibility from Java 1.3 to Java 1.2 which does not support the Proxy 

class This method is not yet implemented 

Parameters: 

entry - Entry to cast, 'entry' must have been acquired by calls to DirectoryController.lookupO, 
DirectoryController search(), or DirectoryController.newEntryInstance() Must not be null 
interf aceioCastTo - This is the interface that the specfied 'entry' is to be cast to 
Returns: 

Object which can be cast to the type specified by f interfaceToCastTo\ 
Throws: 

iava . lang . ciassCas tException - if the specified 'entry' cannot be cast to the specified 
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'interfaceToCastTo' 



getDN 

public java.lang. String getDN j ava . iang . Obi ect entry) 

Use to get the specified 'entry' distinquishe lame 
Parameters: 

entrv - Entrv to obtain distinquished name from 'entry 1 must have been acquired by calls to 
DirectoryController lookupO, DirectoryController search(), or DirectoryController new Entry Instance( ) 
Must not be null. 
Returns: 

String containing the specified 'entry' distinquished name 
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com.gepcm er.sfo.tool.ldap 

Class DefaultDirectorySource 

java . lang . Obiect 

com. gepower . sf o . too" 1 . 1 dap . DefaultDirectorySource 

Ail Implemented Interfaces: 

Director /Source 



public class DefaultDirectorySource 

extends java. Iang Object 
implements DirectorySource 

ijpirectorySource implementation See DirectorySource for discription of implemented methods 





Constructor Summary 


,ssr 


; DefaultDirectorySource !iava . util . Hashtacle envi ronme-i^ > 








Method Summary 






discardDirContext { iavax.namina. directory. ni rfnnfpvf mnt^yr ) 

Use to discard the specified 'context'. 






cjetDirContext ( ) 

Use to get a JNDI DirContext object 




void 


releaseDirContext (iavax.namina . di rer.r.orv.m rrnnrPYf ^ n tAvt , 

Use to release the specified 'context' 








Methods inherited from class java.lang.Object 




clone, equals, finalize, getClass, hashCode, notify, notifyAil, toStnng, wait, wait, wait 



Constructor Detail 



9 



Page 1 of 



(24376)\8007 (LDAP)\US01^ 



DefaultDirectorySource 

Dublic DefaultDirectorySource' java. til . Hasntabie environm 

throws -avax. naming. Nareir.gExcepci on 



Method Detail 

getDirContext 

public javax. naming. directory. DirContext getDirContext') 

throws ] avax. naming . NammgExcept icn 

Description copied from interface: DirectorySource 

Use to get a JNDI DirContext object 
Specified by: 

cetDirCcntex t in interface DirectorySource 
Following copied from interface. com. gepcwer.sfo. tool. Idap. DirectorySource 
: Returns: 
} DirContext object 

t Throws: 

I j avax. naming. NammgException - if a naming exception is encountered 



■releaseDirContext 

rfcublic void releaseDirContext ( 3 avax . naming . directory . DirContext context) 

Description copied from interface: DirectorySource 

In Use to release the specified 'context'. This should be called when the context is no longer needed, 
y, Specified by: 

releaseDirContext in interface DirectorySource 
Following copied frc~ ^ interface com. gepower . sf c . tool . idap . DirectorySource 

Parameters: 

context - The context to release. 



discardDirContext 

public void discardDirContext (j avax. naming. directory. DirContext context) 
Description Copied from interface: DirectorySource 

Use to discard the specified 'context' 
Specified by: 

discardDirC o ntext in interface DirectorySource 
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Fallowing Copied from interface; com. gepower.sfo. tool. Idap.DirectorySource 

Parameters: 

context - The context to release 



Overview Package Class Tree Deprecated Index Hel p 



PREV CLASS NEXT_CLASS FRAMES NO FR AMES 

SUMMARY. INNER 1 FIELD i CONSTR ' M ETHOD DETAIL FIELD j CONSTR METHOD 
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com.gepower.sfo.tool.ldap 

Class DirectoryEntry 

j ava . lang . Cb^ ect 

+— com. gepower . sf o . tool . ldap . DirectoryEntry 

All Implemented Interfaces: 

java.lang reflect. InvocationHandlerJava.io Serializable 



public class DirectoryEntry 

^extends java lang Object 

implements java io. Serializable. java.lang reflect. InvocationHandler 

s. 3 

yEepresents an LDAP Directory Entry and a LDAP invocation handler used in Proxy instances Each proxy instance 
fjfias an associated invocation handler When a method is invoked on a proxy instance, the method invc :ion is 
IJIencoded and dispatched to the invoke method of its invocation handler. This is a package scope class and not used 
tfldirectly by clients 

LSee Also: 

S™">5 

f=f InvocationHandler, java . lang . reflect . Proxy, Serialized Form 



Method Summary 




invoke ( 1 ava . lanq . Obi ect proxy, i ava . lanq . reflect . Method method, 
j ava . lang . Ob] ect [ ] args) 

Implement abstract method invoke() from InvocationHandler 




toStrina; (i ava. lana. Object proxy, lava . lanq . reflect . Method method) 
Returns the contents of all attribute in this entry 



Methods inherited from class java.Iang*Object 

clone, equals, ^malize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 



Method Detail 
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invoke 



public java.lang.Obiect invoke { j ava . lang . Ob] ect proxy, 

java.lang. reflect .Method method, 
j ava . lang . Obi ect [ ] args ) 
throws j ava . lang . Throwable 



Implement abstract method invoke() from InvocationHandler This method only recognizes methods that ha\e 
been declared in the generated interfaces 
Specified by: 

invoke in interface ]ava . lang . reflect . InvocationHandler 

Parameters: 

proxy - the proxy instance that the method was invoked on. 

method - the Method instance corresponding to the interface method invoked on the proxy instance The 
declaring class of the Method object will be the interface that the method was declared in, which may be 
a superinterface of the proxy interface that the proxy class inherits the method through, 
args - an array of objects containing the values of the arguments passed in the method invocation on the 
proxy instance, or null if interface method takes no arguments. Arguments of primitive types are 

p wrapped in instances of the appropriate primitive wrapper class, such as java.lang. Integer or 

y3 java.lang. Boolean. 

;f Throws: 

W n ava . lang . Throwable - the exception to throw from the method invocation on the proxy instance The 

exception's type must be assignable either to any of the exception types declared in the throws clause of 
^ the interface method or to the unchecked exception types java.lang. RuntimeException or java.lang Error 

cl If a checked exception is thrown by this method that is not assignable to any of the exception types 

" declared in the throws clause of the interface method, then an UndeclaredThrowableException 

p containing the exception that was thrown by this method will be thrown by the method invocation or *he 

jU proxy instance 

Q See Also: 

rfi 3 ava . lang . reflect . UndeclaredThrowableException 



toString 



public java . lang . String toString ( j ava . lang . C^j ect proxy, 

j ava . lang .reflect . Method method } 



Returns the contents of all attribute in this entry Use for debugging purposes only 
Parameters: 

proxy - The Proxy object serviced by this InvocationHandler. 
method - The Method object invoked on the Proxy 
Returns: 

The contents of all attributes in this entry 
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com.gepower.sfo.tool.ldaj) 

Class DirectoryManagerFactory 

j a va . I ana . C03 ear 

*--com.gepower . sf o . tool . ldap . DirectoryManagerFactory 



public class Directon'ManagerFactory 

extends Java lang Object 

Use to create an object which implements the DirectoryManager interface. 



^Constructor Summary 


^^DirectoryManagerFactory ' ; 




□Method Summary 




newDirectoryManager ; Direct or yS our ce src, 1 ava . lana . Strma pka) 

Creates a new object which implements the DirectoryManager interface using the 
specified 'src' and 'pkg' 




newDirectoryManager ( Director ySource src, lava. lana. Strma pka, 
java.lang.ClassLoader loader) 

Creates a new object which implements the DirectoryManager interface using the 
specified 'src 1 , 'pkg', and 'loader'. 




newDirectoryManager f Di _ ctorySource src, 1 ava . lana . Strma pka, 
java.lang.ClassLoader loader, 3 ava . 10 . PrmtStream logger) 

Creates a new object which implements the DirectoryManager interface using the 
specified 'src', 'pkg', 'loader', and 'logger' 




newDirectoryManager (1 ava. utii . Hashtable env f 1 ava . 1 ang _ St n ng pkg^ 

Creates a new object which implements the DirectoryManager interface using the 
specified 'env' and 'pkg'. 
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newDirectorvManage r ( j ava . util ■ Hashtable env, java . lang . String p*;g, 
lava.lang-ClassLoader loader 1 

Creates a new object which implements the Director/Manager interface using the 
specified 'env\ 'pkg', and loader' 

newDirectoryManaqer hava . util . Hashtable env, i ava . lang . St ring pkg, 
java.lang.ClassLoader loader, j ava . 10 . PnntStrear. logger 

Creates a new object which implements the DirectoryManager interface using the 
specified 'env\ f pkg\ 'loader', and 'logger' ^ 



Methods inherited from class java.lang.Object 



done, equals, finalize, getClass, hashCode, notify, notifyAll, tcStrmg, 



Constructor Detail 



DirectoryManagerFactory 

^public DirectoryManagerFactory ( ! 



Method Detail 



J! 

jaewDirectoryManager 

public static DirectoryManager newDirectoryManager ! ] ava . util . Hashtaole env, 

fT ] ava . lang . String pkg; 

L_ throws 3 ava . lang . IllegalArgumencException, 

■W s ]avax . naming . NamincExceotion 

:: 

Creates a new object which implements the DirectoryManager interface using the specified 'env 1 and 'pkg' 
" Parameters: 

env - Used to specify various preferences and properties that define the environment in which naming 
and directory services are accessed. Must not be null 

pkg - The Java package in which the LDAP interfaces were generated under Must not be null. 
Throws: 

java. lang. IllegalArgumentException - if 'env 1 or 'pkg' is null. 

j avax . naming . NamingException - if a naming exception is encountered 



newDirectorvManager 

public static DirectoryManager newDirectoryManager f j ava . util . Hashtable env, 

j ava . lang . String pkg, 
] ava . lang . ClassLoader loader) 
throws ]ava. lang . IllegalArgumentException, 
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j avax . naming . NammgException 

Creates a new object which implements the DirectoryManager interface using the specified 'env', 'pkg'. and 

'loader 1 

Parameters: 

env - Used to specify various preferences and properties that define the environment in which naming 
and directory services are accessed Must not be null. 

pkg - The Java package in which the LDAP interfaces were generated under Must not be null 
loader - Class loader u use to load proxy classes May be null in which case the current threads class 
loader will be used 
Throws: 

]ava, iang. IllegalArgumentException - if 'env* or 'pkg' is null. 

] avax. naming . NammgException - if a naming exception is encountered. 



newDirectoryManager 

public static DirectoryManager newDirectoryManager <' java . util . Hashtabie env, 

;java. Iang. String pkg, 
java . Iang . Clas sLoader loader, 
java.io. PnntStream logger) 
throws ]ava . Iang . IllegalArgumentException, 
1 avax . naming . NammgException 

Creates a new object which implements the DirectoryManager interface using the specified 'env', 'pkg'. 'loader' 

and 'logger' 

Parameters: 

env - Used to specify various preferences and properties that define the environment in which naming 
and directory services are accessed. Must not be null. 

p.<g - The Java package in which the LDAP interfaces were generated under Must not be null 
loader - Class loader to use to load proxy classes May be null in which case the current threads class 
loader will be used. 

logger - This is where all debug trace messages will be written to. 
Throws: 

]ava. Iang. IllegalArgumentException - if'env' or 'pkg' is null. 

j avax. naming. NammgException - if a naming exception is encountered 



newDirectoryManager 

public static DirectoryManager newDirectoryManager ( Dire ct or vSource src, 

java. Iang. String pkg; 
throws nava . Iang. IllegalArgumentException, 
j avax . naming ♦ NammgException 

Creates a new object which implements the DirectoryManager interface using the specified 'src' and 'pkg 1 
Parameters: 

src - Specifies the what directory source the DirectoryManager will use. Must not be null. 



17 



Page 3 of 



4376)\8007 (LDAP)\US01^ 



pkg - The Java package in which the LDAP interfaces were generated under Must not be null 
Throws: 

java . lang . UlegalArgumentExcepticn - if 'src' or 'pkg 1 is null 
javax. naming. NamingException - if a naming exception is encountered. 



newDirectoryManager 

public static Dir e ctorvManager newDirectoryManager { Director ySource src, 

]ava . lang. String pkg r 
java . lang . ClassLoader loader, 
throws java . lang . UlegalArgumentException, 
J avax . naming , NamingExceptior. 

Creates a new object which implements the DirectoryManaaer interface using the specified src' 'pke' and 

'loader'. 

Parameters: 

src - Specifies the what directory source the DirectoryManager will use Must not be null 
. pkg - The java package in which the LDAP interfaces were generated under. Must not be null, 

j loader - Class loader to use to load proxy classes May be null in which case the current threads class 

I loader will be used. 

Throws: 

i ]ava. lang. UlegalArgumentException - if 'src' OT 'pkg' is mill 

-avax, nammg. NammgExcepticn - if a naming exception is encountered 



-newDirectoryManager 

-is 

-public static Dire cto rvManager newDirectoryManager ( Di recto rySource src, 

] ava . lang . String pkg, 
]ava . lang . ClassLoaaer loader, 
]ava.io,PrmtStream logger] 
throws i ava . lang . UlegalArgumentException, 
j avax . naming . NammgException 

Creates a new object which implements the DirectoryManager interface using the specified f src\ 'pkg', loader', 
and 'logger' 
Parameters: 

src ~ Specifies the what directory source the DirectoryManager will use. Must not be null, 
pkg - The Java package in which the LDAP interfaces were generated under. Must not be null, 
loader - Class loader to use to load proxy classes. May be null in which case the current threads class 
loader will be used. 

logge_ - This is where all debug trace messages will be written to. 
Throws: 

java . lang . UlegalArgumentException - if 'src' or 'pkg' is null 

javax. nammg. Nam_ng Except ion - if a naming exception is encountered. 
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com.gepower.sfo.tool.ldap 

Class Generator 

j a va . 1 ang . Ob j e z t 

-+-~-com. gepower , sf o . tool . ldap . Generator 



public abstract class Generator 
extends java. lang Object 

Generates java interfaces which represents LDAP object classes. These classes are used in the java LDAP Directors' 
Hramework This class is abstract can contains only static methods. This class contains a main() method and is 
Resigned to be executed from the command line. See method description for main() for more details 

lllee Also: 

111 main ( i ava . lanq . String [ ] ; 



Constructor Summary 



Generator ( • 



Method Summary 



znain ( j a va . lang . String [ ] args) 

Usage: java com, gepower.sfo. tool. ldap. Generator params [options] 



Methods inherited from class java.lang. Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, toStrmg, wait, wait, wait 



Constructor Detail 

Generator 

public Generator f ) 
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Method Detail 



main 

public static void main ( java . lang. String [ ] args) 

Usage java com.gepower.sfo tool.ldap Generator params [options] 

To print out aeip, use the -help option when executing this program from the command line 
Parameters: 

args - Array of String arguments which consists of the required and optional parameters 

Required Parameters 

• -sourcerootpath 1 the root directory path for the generated java source 

• -package 1 the java package for the generated java source 

1 • -dirctxfactory' class to use for the initial directory context factory 

1 • '-providerurl' the LDAP URL string (i.e., Idap //localhost 389/o=ge com) 

i • '-securityprincipal' identity of the principal for authenticating the caller to the service 

I • -securitycredentials' credentials of the principal for authenticating the caller to the service 

] • -securityauthentication 1 security level to use 



Optional Parameters: 

• -exclude' object classes matching the wildcard will be excluded from code generation Exclusions 
have precedence over Inclusion Multiple wildcards can be specified separated by semi-colons (i e. 
"ns*, ob*, net*server") 

• -include' object classes matching the wildcard will be included in code generation If option not 
specified, include all object classes Multiple wildcards can be specified, see exclude option 

• -version' version number that will be included into the javadoc of the generated code, 

• '-tabstop' tab stop to use when formatting the generated code 

• '-help' use to print usage syntax on the command line 

• '- T use to print usage syntax on the command line 



Ov erview Package Class Tree Deprecated I ndex Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER | FIELD j CON5TR f METHOD DETAIL FIELD ] CONSTR J METHOD 



21 

Page 2 of 



GE Company CASPER vl.O API Specification: Package com.gexasper.http.jsp 



Overview Package Class Tree Deprecated Index Help 
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Package com.ge.casper.http.jsp 

Provides the interfaces and classes that define the contract that JspPreparer subclasses have with the 
framework. 



See: 

Description 



Class Summary 


JspPreparer 


Provides an abstract class to be subclassed for creating a view handler that prepares 
data beans and resources for subsequent use by a JSP that will render the response to 
the client. 





Package com.ge.casper.http.jsp Description 

Provides the interfaces and classes that define the contract that JspPreparer subclasses have with the 
framework. 



Overview Package Class Tree Deprecated Index Help 

PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES 
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com.ge.casper.http.jsp 

Class JspPreparer 

j ava . lang . Ob j ect 

I 

+ — com. ge . casper . http . j sp . JspPreparer 



All Implemented Interfaces: 

ViewHandler 



public abstract class JspPreparer 

extends java.lang. Object 
implements ViewHandler 



Provides an abstract class to be subclassed for creating a view handler that prepares data beans and 
resources for subsequent use by a JSP that will render the response to the client. 

A subclass must override the doService method, and may override the dolnit and doDestroy methods. 

Version: 

1.0 

Author: 

Jeff Tuatini 



Field Summary 



static java.lang. String 



JSP NAME 



Constructor Summary 



JspPreparer ( ) 
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Method Summary 


void 


destroy { ) 

Called by the framework to indicate to a translator that it is being taken out 
of service. 


protected void 


doDestroy ( ) 

Overridden by the subclass to release resources. 


protected void 


dolnit (ViewHandlerConficf confia, HttpContainerContext ctx) 

Overridden by the subclass to perform initialization. 


protected 
j ava . lang . String 


doPrepareForJspfViewReauest vreq, HttpContainerReauestContext ctx) 

Overridden by the subclass to prepare data beans and resources from the 
view request for subsequent use by a JSP. 


void 


init (ViewHandlerConficf confiq) 

Called by the framework to indicate to a view handler that it is being placed 
into service. 


void 


service (ViewRequest vreq r ResponseChannel out, 
ContainerRecruestContext containerCtx) 

Called by the framework to allow a view handler to transform and return a 
response back to the external client. 



Methods inh erited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, 
wait, wait 



1 I Field Detail 



^ JSP_NAME 

public static final j ava. lang. String JSP_NAME 



Constructor Detail 



JspPreparer 

public JspPreparer ( ) 



Method Detail 



init 

public final void init ( ViewHandlerConf icf config) 
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throws SystemException 

Description copied from interface: viewHandier 

Called by the framework to indicate to a view handler that it is being placed into service. 

The framework calls the init method exactly once after instantiating the view handler. The 
init method must complete successfully before the view handler can receive any requests. 

Specified by: 

init in interface ViewHandier 
Following copied from interface: com. ge . casper . app . view. ViewHandier 

Parameters: 

conf ig - a viewHandierConf ig object containing the view handler's configuration and 
initialization parameters. Also provides access to the Environmentcontext object that 
enables access to the resources of the application. 
Throws: 

SystemException - if an exception has occurred that interferes with the view handler's 
normal operation. 



destroy 

public final void destroy () 

Description copied from interface: viewHandier 

Called by the framework to indicate to a translator that it is being taken out of service. 
Specified by: 

destroy in interface ViewHandier 



service 

public final void service ( ViewRe quest vreq, 

ResponseChannel out, 

ContainerRequestContext containerCtx) 
throws SystemException 

Description copied from interface: ViewHandier 

Called by the framework to allow a view handler to transform and return a response back to the 
external client. 

The response returned from the action handler that is to be transformed is contained in the 
viewRequest argument. The ResponseChannel argument is used by the view handler to return 
the transformed response to the client. 

This method is only called after the view handler's init method has completed successfully. 

View handlers run inside a multithreaded environment in which multiple responses must be 
transformed concurrently. Access to the view handler's class and instance variable must 
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therefore be synchronized if they are updateable within the service method. 

Specified by: 

service in interface ViewHandler 
Following copied from interface: com. ge.casper.app. view. ViewHandler 

Parameters: 

req - a viewRe guest object that contains the response message to be transformed. 

out - a Responsechannei object that the view handler will use to return the transformed 

response to the client. 

context - the containerReauestcontext used to provide access to container adapter 
contextual information and resources related to the request. Container adapters may ^ 
provide specialized subinterfaces to provide access to resources specific to the container 
adapter type. 
Throws: 

SvstemException - if an exception has occurred that interferes with the view handler's 
normal operation. 



dolnit 

protected void dolnit ( ViewHandlerConf iq config, 

HttpContainerContext ctx) 
throws SvstemException 

Overridden by the subclass to perform initialization. 



doPrepareForJsp 

protected java . lang . String doPrepareForJsp ( ViewRe quest vreq, 

HttpContainerRequestContext ctx) 
throws SvstemException 

Overridden by the subclass to prepare data beans and resources from the view request for 
subsequent use by a JSP. Generally, the data beans and resources that are prepared will be made 
available to a subsequent JSP as named attributes of a servlet object (eg, ServletRequest) 

accessible from the HttpContainerRequestContext and HttpContainerContext objects. 

Upon the subclass returning from this method call, this base class will dispatch a JSP to render 
the response to the client. The JSP that is dispatched is determined by the return value of this 
method call. If this method returns null, the JSP whose name is specified with the JSP 
initialization parameter in the casper-appiication . xmi file is dispatched. If this method 
returns a string value, the string specifies the name of the JSP to be dispatched. 



doDestroy 

protected void doDestroy () 
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Overridden by the subclass to release resources. 
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com.ge.casper.app.view 

Interface ViewHandler 

All Known Implementing Classes: 

Http ViewHandler , JspPreparer 



public interface ViewHandler 

Defines methods that all view handler components must implement. 

A view handler component is responsible for transforming the response returned from an action 
handler into a presentation supported by the client. The application framework selects a view handler 
to perform this task based upon the logical view name returned from the action handler and the 
response encoding supported by the client. 

There is a wide range of possible implementations and capabilities for view handlers; a view handler 
instance may be specialized for a specific logical view name and response encoding, or it may be 
generic supporting all logical view names and response encodings. 

ViewHandler Declaration 

View handlers are declared in casper-appiication.xmi configuration files with view-handier 
elements. The mapping of view handlers to views are specified with view-handler-mapping elements 
which are grouped by encoding. Refer to the casper-appiication-i . o . dtd for more details on 
configuration. The framework reads these configuration files in order of narrowing scope, and reads 
the elements within each configuration file in the order that they are declared. A view-handler 
element will replace an earlier declared element of the same type and name. A view-handler- 
mapping element will replace an earlier declared view-handler-mapping element of the same name 
under the same encoding. 

A single view handler may be mapped to multiple views across different encodings. 

The following encoding and view names have special meaning to the framework. How these names are 
used in the algorithm that the framework uses to retrieve a view handler for returning a response is 
described later. 

• A view handler mapped to a view declared for the any encoding supports the view for any 
encoding. 

• A view handler mapped to an any view supports any view under the encoding that the any view 
is declared. There may only be a single any view for each encoding. 

• A view handler mapped to a system-error view is called by the framework to return an error 
message under the encoding that the system-error view is declared. There must be declared a 
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system-error view for each encoding. 
ViewHandler Selection 

The application framework follows the following algorithm to select an view handler to return a 
response message: 

• The application framework retrieves a view handler supporting the given view name and 
encoding. 

• If none exists, the framework will retrieve the view handler that is configured for the any view 
and the given encoding. 

• If none exists, the framework will retrieve the view handler that is configured for the given view 
name and the any encoding. 

• If none exists, the framework will retrieve the view handler that is configured for the any view 
and the any encoding. 

• If none exists, the framework will display an error message using the view handler for the 
system- error view and given encoding. There must be a view handler for the system-error 
view for every encoding. 

ViewHandler Lifecycle 

This interface defines methods to initialize a view handler, to transform responses, and to remove a 
view handler from the framework. These methods are called in the following sequence: 

• The view handler is constructed, then initialized with the init method. 

• Any calls from the framework to transform and return responses are handled. 

• The view handler is taken out of service, then destroyed with the destroy method, then 
garbage collected and finalized. 

ViewHandler Concurrency 

Within an application, there is only a single instance of each view handler. An instance of a view 
handler may be executed concurrently in multiple threads to transform multiple responses for returning 
to multiple clients. Therefore, a view handler must be programmed to be thread safe. 

Version: 

1.0 
Author: 

Jeff Tuatini 



Method Summary 


void 


destroy ( ) 

Called by the framework to indicate to a translator that it is being taken out of service. 


void 


init (ViewHandlerConfiq conficr) 

Called by the framework to indicate to a view handler that it is being placed into service. 
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void 



service ( ViewRequest req, ResponseChannel out, 



ContainerRequest Context context) 



Called by the framework to allow a view handler to transform and return a response 
back to the external client. 



Method Detail 



public void init ( ViewHandler Con f iq config) 
throws SystemException 

Called by the framework to indicate to a view handler that it is being placed into service. 

The framework calls the init method exactly once after instantiating the view handler. The 
init method must complete successfully before the view handler can receive any requests. 

Parameters: 

config - a ViewHandler Con f ig object containing the view handler's configuration and 
initialization parameters. Also provides access to the Environmentcontext object that 
enables access to the resources of the application. 
Throws: 

SystemException - if an exception has occurred that interferes with the view handler's 
normal operation. 



service 



public void service ( ViewRequest req, 

ResponseChannel out, 
ContainerRequestContext context) 
throws SystemException 

Called by the framework to allow a view handler to transform and return a response back to the 
external client. 

The response returned from the action handler that is to be transformed is contained in the 
ViewRequest argument. The ResponseChannel argument is used by the view handler to return 
the transformed response to the client. 

This method is only called after the view handler's init method has completed successfully. 

View handlers run inside a multithreaded environment in which multiple responses must be 
transformed concurrently. Access to the view handler's class and instance variable must 
therefore be synchronized if they are updateable within the service method. 

Parameters: 
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req - a viewRequest object that contains the response message to be transformed. 

out - a Responsechannei object that the view handler will use to return the transformed 

response to the client. 

context - the ContainerRequestcontext used to provide access to container adapter 
contextual information and resources related to the request. Container adapters may 
provide specialized subinterfaces to provide access to resources specific to the container 
adapter type. 
Throws: 

SvstemException - if an exception has occurred that interferes with the view handler's 
normal operation. 



destroy 

public void destroy () 

Called by the framework to indicate to a translator that it is being taken out of service. 



O Overview Package Class Tree Deprecated Index Help 

'€ I PREV CLASS NEXT CLASS FRAMES NO FRAMES 
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Package com.ge.casper.http 

Provides the interfaces and classes that defines the contract that view components have with a "http- 
servlet" container type in which the application is deployed as a Servlet web application. 



See: 

Description 



Interface Summary 


HttpContainerContext 


Extends the containerContext interface to provide access to the 
servietcontext of the http-servlet container. 


HttpContainerRequestContext 


Extends the containerReauestcontext interface to define 
methods to access HTTP servlet resources maintained by the http- 
servlet container for the current request. 


HttpLinkEncoder 


Defines methods for encoding an action name and parameters into a 
URL. 



Class Summary 


HttpJspDispatcherHandler 


Provides an abstract class to be subclassed to assist in creating a view 
filter that requires access to a http-servlet specific resources. 


HttpServIetBridgeFilter 


Provides an abstract class to be subclassed to assist in creating a view 
filter that requires access to a http-servlet specific resources. 


HttoServIetBridgeSingleton 




HttpViewFilter 


Provides an abstract class to be subclassed to assist in creating a view 
filter that requires access to a http-servlet specific resources. 


HttpViewHandler 


Provides an abstract class to be subclassed to assist in creating a view 
filter that requires access to a http-servlet specific resources. 



Package com.ge.casper.http Description 

Provides the interfaces and classes that defines the contract that view components have with a "http- 
servlet" container type in which the application is deployed as a Servlet web application. 



Overview Package Class Tree Deprecated Index Help 

PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES 
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conhge.casper.http 

Interface HttpContainerContext 

All Superinterfaces: 

ContainerContext 



public interface HttpContainerContext 

extends ContainerContext 

Extends the ContainerContext interface to provide access to the ServletContext of the http- 

servlet container. 

Version: 

1.0 
Author: 

Jeff Tuatini 



Method Summary 


j avax. servlet . ServletContext 


aetServletContext ( ) 


Returns the ServletContext object. 



Methods inherited from interface com.ge.casper.app.container. ContainerContext 

qetAdapterName , qetAdapterVersion , qetContainerTvpe 



Method Detail 



getServletContext 

public j avax. servlet . ServletContext getServletContext ( ) 
Returns the ServletContext object. 



Overview Package Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER j FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR 1 METHOD 
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com. ge.casper.http 

Interface HttpContainerRequestContext 

All Superinterfaces: 

ContainerRequestContext 



public interface HttpContainerRequestContext 

extends ContainerRequestContext 

Extends the ContainerRequestContext interface to define methods to access HTTP servlet 
resources maintained by the http-servlet container for the current request. 

■ S Version: 

[ft Author: 

III JeffTuatini 



Method Summary 


Httr>LmkEncoder 


qetHttpLinkEncoder ( ) 

Returns the HttpLinkEncoder for encoding actions 
and URLs within the context of the current request. 


javax . servlet . http . HttpServletRequest 


getHttpServletRequest ( ) 

Returns the HttpServletRequest underlying the 
current request. 


j avax . servlet . http. HttpServletResponse 


getHttpServletResponse ( ) 

Returns the HttpServletResponse underlying the 
current request. 



Methods inherited from interface com.gexasper.app.container. ContainerRequestContext 

qetSessionld , isUserlnRole , loqoutUser 



Method Detail 



getHttpLinkEncoder 
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public HttpLinkEncoder getHttpLinkEncoder ( ) 

Returns the HttpLinkEncoder for encoding actions and URLs within the context of the current 
request. 

getHttpServletRequest 

public javax.servlet . http . HttpServletRequest getHttpServletRequest ( ) 

Returns the HttpServletRequest underlying the current request. 
getHttpServletResponse 

public javax. servlet . http . HttpServletResponse getHttpServletResponse ( ) 

Returns the HttpServletResponse underlying the current request. 
Overview Package Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER 1 FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 



14 

file://C:\patent - JDW\GEPS (24376)\Disclosure Mater.., \HttpContainerRequestContext.htm 01/02/2001 



GE Company CASPER vl.O API Specification: Interface HttpLinkEncoder 
Overview Package Class Tree Deprecated Index Help 



FRAMES NO FRAMES 

DETAIL: FIELD | CONSTR | METHOD 



PREV CLASS NEXT CLASS 
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com.ge.casper.http 

Interface HttpLinkEncoder 

All Superinterfaces: 

LinkEncoder 



public interface HttpLinkEncoder 

extends LinkEncoder 

Defines methods for encoding an action name and parameters into a URL. 

Version: 
1.0 
Author: 

Jeff Tuatini 



Method Summary 


java .lang . String 


encodeAction (iava. lanq. String action) 

Encodes the given action name into a URL. 


java .lang. String 


encodeAction ( i ava . lanq . String action, 
j ava . lang . String queryString) 

Encodes the given action name and query string into a URL. 


java .lang . String 


encodeAction (iava. lanq. String action, iava . lanq . String [ ] 
[] nvPairs) 

Encodes the given action name and parameters into a URL. 


java .lang .String 


encodeRedirectAction ( i ava . lanq . Strinq action) 

Encodes the given action name into a URL for use in a sendRedirect call. 


j ava . lang . String 


encodeRedirectAction ( i ava . lanq . Strinq action, 
java . lang. String queryString) 

Encodes the given action name and query string into a URL for use in a 
sendRedirect call. 


j ava . lang . String 


encodeRedirectAction (iava. lanq. String action, iava. lang. Strinq [ ] 
[] nvPairs) 

Encodes the given action name and parameters into a URL for use in a 
sendRedirect call. 
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j ava . lang . String 


encodeRedirectURL ( i ava . lanq . String url ) 

Encodes the given URL with any necessary container session data for use in 
a sendRedirect call. 


java . lang .String 


encodeURL (iava. lanq. Strinq url) 

Encodes the given URL with any necessary container session data. 



Method Detail 



encodeAction 

public java. lang. String encodeAction (java. lang. String action) 

Encodes the given action name into a URL. 
Specified by: 

encodeAction in interface LinkEncoder 



encodeAction 

public j ava . lang. String encodeAction ( j ava . lang . String action r 

java . lang. String [][ ] nvPairs) 

Encodes the given action name and parameters into a URL. 
Specified by: 

encodeAction in interface LinkEncoder 



encodeAction 

public java. lang. String encodeAction (java . lang. String action, 

java. lang. String queryString) 

Encodes the given action name and query string into a URL. 
Specified by: 

encodeAction in interface LinkEncoder 



encodeURL 

public java. lang. String encodeURL (java . lang . String url) 

Encodes the given URL with any necessary container session data. 
Specified by: 

encodeURL in interface LinkEncoder 
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encodeRedirectAction 

public java.lang. String encodeRedirectAction (java . lang. String action) 
Encodes the given action name into a URL for use in a sendRedirect call 



encodeRedirectAction 

public java . lang. String encodeRedirectAction (java . lang . String action, 

java . lang. String [][ ] nvPairs) 

Encodes the given action name and parameters into a URL for use in a sendRedirect call 



encodeRedirectAction 

public java . lang . String encodeRedirectAction ( j ava . lang. String action, 
~J j ava . lang. String queryString) 

in Encodes the given action name and query string into a URL for use in a sendRedirect call 



encodeRedirectURL 

public j ava . lang . String encodeRedirectURL ( j ava . lang . String url) 

Encodes the given URL with any necessary container session data for use in a sendRedirect call. 



Overview Package Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS 
SUMMARY: INNER | FIELD | CONSTR | METHOD 



FRAMES NO FRAMES 

DETAIL: FIELD I CONSTR I METHOD 
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SUMMARY: INNER | FIELD \ CONSTR | METHOD 



com.ge.casper.http 

Class HttpJspDispatcherHandler 

j ava . lang . Object 

1 

+ — com. qe . casper ■ http . HttpViewHandler 
i 

+ — com. ge . casper . http . HttpJspDispatcherHandler 

All Implemented Interfaces: m 

ViewHandler 



public class HttpJspDispatcherHandler 

extends HttpViewHandler 

Provides an abstract class to be subclassed to assist in creating a view filter that requires access to a 
http-servlet specific resources. 

A subclass must override the do Service method, and may override the dolnit and doDestroy methods. 
The other protected methods are helper methods for use by the subclass to assist in providing storage 
and access to initialization patameters and context objects. This class also downcasts the container 
context objects to their HTTP subtypes as provided by the http-servlet container. 

Developers need not extend this class to implement a ViewFilter that executes in a http-servlet 
container; they can implement the ViewFilter interface directly and perform the necessary downcasts 
to access HTTP specific resources. 

Version: 

1.0 
Author: 

JeffTuatini 



Field Summary 


static j ava . lang . String 


JSP NAME 
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Constructor Summary 

HttpJspDispatcherHandler ( ) 



Method Summary 


protected 
void 


dolnit ( ) 

The subclass overrides this method to initialize itself. 


protected 
void 


doService (ViewReguest vreq, ResponseChannel out, 


HttpContainerReguestContext ctx) 

The subclass must override this method to process the view request. 



Methods inherited from class com.gexasper.http.HttpViewHandjer 

destroy , doDestroy , get Environment Context , getHttpContainerContext , 

get Init Parameter , getlnitParameterNames , get Name , getViewContext , init , service 



Meth ods inherited from class javaJang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, 
wait, wait 

Field Detail 

JSP_NAME 

public static final j ava . lang . String JSP_NAME 

Constructor Detail 

HttpJspDispatcherHandler 

public HttpJspDispatcherHandler ( ) 

Method Detail 

dolnit 

protected void dolnit () 

throws SystemException 

Description copied from class: HttpViewHandier 

The subclass overrides this method to initialize itself. 
Overrides: 
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doService 

protected void doService ( ViewRequest vreq, 

ResponseChannel out, 
HttpContainerRequestContext ctx) 
throws SvstemException 

Description copied from class: HttpviewHandier 

The subclass must override this method to process the view request. The chain parameter 
provides the interface for the subclass to invoke the next filter in the filter chain. 
Overrides: 

doService in class H t tp Vi e wHandl e r 



Overview Package Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER | FIELD | CONSTR j METHOD DETAIL: FIELD | CONSTR | METHOD 
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PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER [ FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR [ METHOD 



com.ge.casper.http 

Class HttpServletBridgeFilter 

java. lang. Object 
I 

+ — com. qe . casper . http ■ HttpViewFil ter 
I 

+ — com. ge . casper . http . HttpServletBridgeFilter 

All Implemented Interfaces: 

ViewFilter 



public class HttpServletBridgeFilter 

extends Http ViewFilter 

Provides an abstract class to be subclassed to assist in creating a view filter that requires access to a 
http-servlet specific resources. 

A subclass must override the doService method, and may override the dolnit and doDestroy methods. 
The other protected methods are helper methods for use by the subclass to assist in providing storage 
and access to initialization patameters and context objects. This class also downcasts the container 
context objects to their HTTP subtypes as provided by the http-servlet container. 

Developers need not extend this class to implement a ViewFilter that executes in a http-servlet 
container; they can implement the ViewFilter interface directly and perform the necessary downcasts 
to access HTTP specific resources. 

Version: 

1.0 
Author: 

Jeff Tuatini 



Field Summary 


static java . lang . String 


ENCODER 


static j ava . lang . String 


REQUEST 


static java .lang. String 


SESSION 
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Constructor Summary 



HttpServletBridgeFilter ( ) 



Method Summary 



protected 
void 



doService ( ViewReguest req, ResponseChannel out, 



HttpContainerReguestContext c, ViewFilterChain chain) 



The subclass must override this method to process the view request. 



Methods inherited from class com.ge.casper.http. HttpViewFilter 



destroy , doDestroy , dolnit , get Environment Context , getHttpContainerContext , 



get Init Parameter , getlnitParameterNames , getName , ge tViewContext , init , service 



Mefhods inherited from class javaJang.Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, 
wait, wait 



Field Detail 



SESSION 

public static final j ava. lang . String SESSION 



REQUEST 

public static final j ava. lang. String REQUEST 



ENCODER 

public static final j ava. lang. String ENCODER 

Constructor Detail 

HttpServletBridgeFilter 

public HttpServletBridgeFilter ( ) 

Method Detail 
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doService 



protected void doService ( ViewRequest req, 

ResponseChannel out, 
HttpContainerRequest Context c, 
ViewFilterChain chain) 
throws SystemException 



Description copied from class: HttpViewFiiter 

The subclass must override this method to process the view request. The chain parameter 
provides the interface for the subclass to invoke the next filter in the filter chain. 
Overrides: 

doService in class HttpViewFiiter 



Overview Package Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER [ FIELD | CONSTR | METHOD DETAIL: FIELD j CONSIR | METHOD 



n 

111 

m 
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com.ge.caspcnhttp 

Class HttpServletBridgeSingleton 

j ava . lang . Ob j ect 
I 

+ — com. ge . casper . http . HttpServletBridgeSingleton 

All Implemented Interfaces: 

java.io.Serializable, Singleton 



public class HttpServletBridgeSingleton 

extends java.lang.Object 

implements Singleton , java.io.Serializable 

See Also: 

Serialized Form 



Field Summary 


static j ava. lang . String 


APP CONTEXT 


static j ava . lang . String 


ENV CONTEXT 


static java .lang . String 


LOGGER 


static java. lang. String 


VIEW CONTEXT 



Constructor Summary 

HttpServletBridgeSingleton ( ) 
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Method Summary 


void 


destroy ( ) 

Called by the framework to indicate to a singleton that it is being taken out of service. 


void 


init (SinqletonConfiq confiq) 

Called by the framework to indicate to a singleton that it is being placed into service. 



Metho ds inherited from class java,Iang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, 
wait, wait 



Field Detail 



VIEW_CONTEXT 

public static final java. lang. String VIEW_CONTEXT 



(J APP_CONTEXT 

Hf public static final java. lang. String APP_CONTEXT 



0 ENV_CONTEXT 

O public static final j ava . lang . String ENV_CONTEXT 




LOGGER 



public static final java . lang . String LOGGER 



Constructor Detail 



HttpServletBridgeSingleton 

public HttpServletBridgeSingleton ( ) 



Method Detail 



init 

public void init ( SinqletonConf iq config) 
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throws SystemException 

Description copied from interface: singleton 

Called by the framework to indicate to a singleton that it is being placed into service. 

The framework calls the init method exactly once after instantiating the singleton. The init 
method must complete successfully for the application to start. This method is called before any 
non-singleton components of the component package have been initialized. 

Specified by: 

init in interface Singleton 
Following copied from interface: com. ge . casper . app . Singleton 

Parameters: 

conf ig - a singietonConf ig object containing the singleton's configuration and 
initialization parameters. Also provides a reference to the Envi ronmentcont ext object 
that enables access to CASPER services, and provides a reference to the component 
package context subtype. 
Throws: 

SystemException - if an exception has occurred that interferes with the singleton's 
normal operation. 



destroy 

public void destroy () 

Description copied from interface: singleton 

Called by the framework to indicate to a singleton that it is being taken out of service. This 
method is called after all non-singleton components of the component package have been 
destroyed. 
Specified by: 

destroy in interface Singleton 



Overview Package Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER j FIELD | CQNSTR | METHOD DETAIL: FIELD | CQNSTR | METHOD 
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com.ge.casper.http 

Class HttpViewFilter 

j ava . lang . Ob j ect 
I 

+ — com. ge . casper . http . HttpViewFilter 

AH Implemented Interfaces: 

ViewFilter 

Direct Known Subclasses: 

HttpServletBridseFilter 



public abstract class HttpViewFilter 

extends java.lang. Obj ect 
implements ViewFilter 

Provides an abstract class to be subclassed to assist in creating a view filter that requires access to a 
http-servlet specific resources. 

A subclass must override the doService method, and may override the dolnit and doDestroy methods. 
The other protected methods are helper methods for use by the subclass to assist in providing storage 
and access to initialization patameters and context objects. This class also downcasts the container 
context objects to their HTTP subtypes as provided by the http-servlet container. 

Developers need not extend this class to implement a ViewFilter that executes in a http-servlet 
container; they can implement the ViewFilter interface directly and perform the necessary downcasts 
to access HTTP specific resources. 

Version: 

1.0 
Author: 

Jeff Tuatini 



Constructor Summary 

HttpViewFilter () 
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Method Summary 


void 


destroy ( ) 

Called by the framework to indicate to an view filter that the filter is 
being taken out of service. 


protected void 


doDestxoy ( ) 

The subclass overrides this method to destroy itself. 


protected void 


dolnitf) 

The subclass overrides this method to initialize itself. 


protected abstract 
void 


doService (ViewRequest req, ResponseChannel out, 


HttpContainerRequestContext ctx, ViewFilterChain chain) 


The subclass must override this method to process the view request. 


protected 
Environment Context 


qretEnvironmentContext { ) 




Returns a reference to the Environmentcontext that provides the filter 
with access to the services of the application. 


protected 
HttoContainerContext 


cretHttpContainerContext ( ) 




Returns a reference to the HttpContainerContext object. 


protected 
j ava . lang . String 


aetlnitParameter ( i ava . lanq . String name ) 

Returns a string containing the value of the named initialization 
parameter, or null if the parameter does not exist 


protected 
java. util . Iterator 


qetlnitParameterNames ( ) 

Returns the names of the view filter's initialization parameters as an 
iterator of string objects, or an empty iterator if the view filter has no 
initialization parameters 


protected 
java. lang. String 


cretName ( ) 

Returns the name of this filter instance. 


protected 
Vi ewContext 


aetViewContext ( ) 

Returns a reference to the viewContext object. 


void 


init (ViewFilterConf iq confiq) 

Called by the framework to indicate to an view filter that it is being 
placed into service. 


void 


service (ViewRe quest req, ResponseChannel out, 
ContainerRequestContext ctx, ViewFilterChain chain) 


Called by the framework to invoke a filter with a request/response pair. 



Methods inherited from class javaJang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, 
wait, wait 



Constructor Detail 



HttpViewFilter 
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Method Detail 



public final void init ( ViewFilterConf iq config) 
throws SystemException 

Description copied from interface: viewFiiter 

Called by the framework to indicate to an view filter that it is being placed into service. 

The framework calls the init method exactly once after instantiating the view filter. The init 
method must complete successfully before the view filter can receive any requests. 

Specified by: 

init in interface ViewFiiter 
Following copied from interface: com. ge. casper.app. view. ViewFiiter 
Parameters: 

config - an ViewFilterConf ig object containing the view filters's configuration and 
initialization parameters. Also provides a reference to the Environmentcontext object 
that enables access to application services, and a reference to the viewcontext object. 
Throws: 

SystemException - if an exception has occurred that interferes with the filter's normal 
operation. 



service 

public final void service ( ViewRequest req, 

ResponseChannel out, 
ContainerRequestContext ctx, 
ViewFilterChain chain) 
throws SystemException 

Description copied from interface: viewFiiter 

Called by the framework to invoke a filter with a request/response pair. An ViewFilterChain 
object is passed in this method to allow the filter to pass the request/response pair onto the next 
filter in the chain. 
Specified by: 

service in interface ViewFiiter 
Following copied from interface: com. ge . casper . app . view. ViewFiiter 
Parameters: 

req - a ViewRequest object containing the data to be transformed for returning to the 
client. 

out - a ResponseChannel object that is to be used to return the transformed response to 
the client. 

context - the containerRequestcontext used to provide access to container adapter 
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contextual information and resources related to the request. Container adapters may 
provide specialized subinterfaces to provide access to resources specific to the container 
adapter type. 

chain - a viewFiiterChain object that is used to invoke the next filter in the chain. 
Throws: 

svstemException - if an exception has occurred that interferes with the filters's normal 
operation. 



destroy 

public final void destroy () 

Description copied from interface: viewFiiter 

Called by the framework to indicate to an view filter that the filter is being taken out of service. 
Specified by: 

destroy in interface ViewFiiter 



getName 

protected j ava . lang . String getName ( ) 

Returns the name of this filter instance. 



getlnitParameter 

protected j ava . lang . String getlnitParameter ( j ava . lang . String name) 

Returns a string containing the value of the named initialization parameter, or null if the 
parameter does not exist 



getlnitParameterNames 

protected j ava . util . Iterator getlnitParameterNames ( ) 

Returns the names of the view filter's initialization parameters as an iterator of string 
objects, or an empty iterator if the view filter has no initialization parameters 



getEnvironmentContext 

protected Envi ronment Context getEnvironmentContext ( ) 

Returns a reference to the Envi ronment context that provides the filter with access to the 

30 

file://C:\patent - JDW\GEPS (24376)\Disclosure Material - overviewV.. \HttpViewFilter.htm 01/02/2001 



GE Company CASPER vl.O API Specification: Class HttpViewFilter 
services of the application. 



Page 5 of 5 



getViewContext 

protected ViewContext getViewContext ( ) 

Returns a reference to the viewcontext object. 
getHttpContainerContext 

protected HttpContainerContext getHttpContainerContext ( ) 

Returns a reference to the HttpContainerContext object, 
dolnit 

protected void dolnit ( ) 

throws SystemException 

The subclass overrides this method to initialize itself 



doService 

protected abstract void doService 

throws 



( ViewRe quest req, 
ResponseChannel out f 
HttpContainerReguestContext ctx, 
ViewFilterChain chain) 
SystemException 



The subclass must override this method to process the view request. The chain parameter 
provides the interface for the subclass to invoke the next filter in the filter chain. 



doDestroy 

protected void doDestroy () 

The subclass overrides this method to destroy itself 



Overview Package Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR f METHOD 
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com.ge.casper.http 

Class HttpViewHandler 

j ava . lang . Ob j ect 
I 

+ — com . ge . casper . http . HttpViewHandler 

AH Implemented Interfaces: 

ViewHandler 

Direct Known Subclasses: 

HttpJspDispatcherHandler 



public abstract class HttpViewHandler 

extends java.lang.Object 
implements ViewHandler 

Provides an abstract class to be subclassed to assist in creating a view filter that requires access to a 
http-servlet specific resources. 

A subclass must override the doService method, and may override the dolnit and doDestroy methods. 
The other protected methods are helper methods for use by the subclass to assist in providing storage 
and access to initialization patameters and context objects. This class also downcasts the container 
context objects to their HTTP subtypes as provided by the http-servlet container. 

Developers need not extend this class to implement a ViewFilter that executes in a http-servlet 
container; they can implement the ViewFilter interface directly and perform the necessary downcasts 
to access HTTP specific resources. 

Version: 

1.0 
Author: 

Jeff Tuatini 



Constructor Summary 

HttpViewHandler ( ) 
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Method Summary 


void 


destroy ( ) 

Called by the framework to indicate to a translator that it is being taken 
out of service. 


protected void 


doDestroy ( ) 

The subclass overrides this method to destroy itself. 


protected void 


dolnit ( ) 

The subclass overrides this method to initialize itself. 


protected abstract 
void 


doService (ViewRequest rea, ResponseChannel out, 


HttpContainerReauestContext ctx) 

The subclass must override this method to process the view request. 


protected 
Environment Con text 


aetEnvironment Con text ( ) 




Returns a reference to the Environment context that provides the filter 
with access to the services of the application. 


protected 
HttpContamerContext 


QetHttpContainerContext ( ) 




Returns a reference to the HttpContainerContext object. 


protected 
j ava . lang - String 


cretlnitParameter ( i ava . lang . String name ) 

Returns a string containing the value of the named initialization 
parameter, or null if the parameter does not exist 


protected 
j ava . util .Iterator 


cfetlnitParameterNames ( ) 

Returns the names of the view filter's initialization parameters as an 
iterator of string objects, or an empty iterator if the view filter has no 
initialization parameters 


protected 
java .lang . String 


QetName ( ) 

Returns the name of this filter instance. 


protected 
ViewContext 


aetViewContext ( ) 

Returns a reference to the ViewContext object. 


void 


init (ViewHandlerConf icr confiq) 

Called by the framework to indicate to a view handler that it is being 
placed into service. 


void 


service (ViewRequest req, ResponseChannel out, 
ContainerReauestContext ctx) 

Called by the framework to allow a view handler to transform and return 
a response back to the external client. 



Methods inherited from class j ava.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, 
wait, wait 



Constructor Detail 
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HttpViewHandler 

public HttpViewHandler ( ) 



Method Detail 



public final void init ( ViewHandlerConf iq config) 
throws SystemException 

Description copied from interface: viewHandier 

Called by the framework to indicate to a view handler that it is being placed into service. 

The framework calls the init method exactly once after instantiating the view handler. The 
init method must complete successfully before the view handler can receive any requests. 

Specified by: 

init in interface ViewHandier 
Following Copied from interface: com. ge . casper . app . view. ViewHandier 

Parameters: 

config - a ViewHandlerConf ig object containing the view handler's configuration and 
initialization parameters. Also provides access to the Environment context object that 
enables access to the resources of the application. 
Throws: 

SystemException - if an exception has occurred that interferes with the view handler's 
normal operation. 



service 

public final void service ( ViewRequest req, 

ResponseChannel out, 
ContainerRequestContext ctx) 
throws SystemException 

Description copied from interface: viewHandier 

Called by the framework to allow a view handler to transform and return a response back to the 
external client. 

The response returned from the action handler that is to be transformed is contained in the 
ViewRequest argument. The ResponseChannel argument is used by the view handler to return 
the transformed response to the client. 

This method is only called after the view handler's init method has completed successfully. 
View handlers run inside a multithreaded environment in which multiple responses must be 
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transformed concurrently. Access to the view handler's class and instance variable must 
therefore be synchronized if they are updateable within the service method. 

Specified by: 

service in interface ViewHandler 
Following copied from interface: com. ge . casper . app . view. ViewHandler 

Parameters: 

req - a viewReguest object that contains the response message to be transformed. 

out - a Responsechannei object that the view handler will use to return the transformed 

response to the client. 

context - the containerReauestcontext used to provide access to container adapter 
contextual information and resources related to the request. Container adapters may 
provide specialized subinterfaces to provide access to resources specific to the container 
adapter type. 
Throws: 

svstemException - if an exception has occurred that interferes with the view handler's 
normal operation. 



destroy 

public final void destroy () 

Description copied from interface: ViewHandler 

Called by the framework to indicate to a translator that it is being taken out of service. 
Specified by: 

destroy in interface ViewHandler 



getName 

protected java . lang. String getName () 

Returns the name of this filter instance. 



getlnitParameter 

protected java . lang, String getlnitParameter (java . lang . String name) 

Returns a string containing the value of the named initialization parameter, or null if the 
parameter does not exist 



getlnitParameterNames 

protected j ava . util . Iterator getlnitParameterNames ( ) 
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Returns the names of the view filter's initialization parameters as an iterator of string 
objects, or an empty iterator if the view filter has no initialization parameters 

getEnvironmentContext 

protected EnvironmentContext getEnvironmentContext ( ) 

Returns a reference to the EnvironmentContext that provides the filter with access to the 
services of the application. 

getViewContext 

protected ViewContext getViewContext ( ) 

Returns a reference to the ViewContext object. 
getHttpContainerContext 

protected HttpContainerContext getHttpContainerContext ( ) 

Returns a reference to the HttpContainerContext object, 
dolnit 

protected void dolnit () 

throws SystemException 

The subclass overrides this method to initialize itself. 
doService 

protected abstract void doService ( ViewReguest req, 

ResponseChannel out, 
HttpContainerReguestContext ctx) 
throws SystemException 

The subclass must override this method to process the view request. The chain parameter 
provides the interface for the subclass to invoke the next filter in the filter chain. 

doDestroy 

36 

file://C:\patent - JDWVGEPS (243 76)\Disclo sure Material - overvie... \HttpViewHandler.htm 01/02/2001 



GE Company CASPER vl .0 API Specification: Class HttpViewHandler Page 6 of 6 

protected void doDestroyU 

The subclass overrides this method to destroy itself. 



Overview Package Class Tree Deprecated Index Help 

PREV CLASS NEXT CLASS FRAMES NO FRAMES 

SUMMARY: INNER | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD 
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